1. Docs
  2. Build tests
  3. Discover
  4. Troubleshooting

Troubleshooting

Find the message or symptom you see. Each entry says why it happens, what to check and how to fix it.

4 min read Updated CustomersAdmins

In short

On this page you can

  • Fix recording problems: missing button, extension, start page URL, no actions found.
  • Solve action and locator issues: amber XPath, duplicates, deleting, clearing Navigates To.
  • Resolve App Map issues such as Not on map and the screenshot limit.
  • Get mobile and desktop capture working with Appium and the agent.

How to use it

  1. Search the page for the exact message or symptom you see.
  2. Open the matching entry in its section, for example Recording or App Map.
  3. Read Why, then work through Check in order.
  4. Apply Fix, then repeat the scan, save or Update map.

Recording#

I don’t see the Discover Your App buttonRecording
Why
It exists only in WEB projects. On Setup Roadmap it is hidden when the roadmap’s Next card already offers it.
Fix
Use Action ListMoreDiscover Your App. In MOBILE and DESKTOP projects use Record Actions or the Desktop Recorder.
The Chrome Web Store opens instead of my app, or “Browser extension still not detected”Recording
Why
The page did not get an answer from the extension within 1.2 seconds.
Fix
Install or enable the extension, press F5 on the SmartestQA tab and try again. Details in Quick Start.
“Please select a Start Page URL.” / “No URL configured for environment”Recording
Why
No start page is selected, or it has no address for the chosen environment. Environments without a URL are greyed out (“No URL defined for this environment”).
Fix
Open the recording settings, pick another environment, or add the URL with Manage URLs.
“No actions found on this page.”Recording
Check
  1. The page had finished loading when you clicked Start Recording.
  2. You are logged in; a session timeout may have sent you to an empty page.
  3. The controls are real interactive elements. Content drawn on a canvas cannot be scanned.
Fix
Wait for the page, click Start Recording again, or capture the few controls you need with Record Actions or New Action.
“Screenshots could not be uploaded — check the CDN/session.”Recording
Why
The extension could not upload screenshots, usually because your SmartestQA session expired or a proxy blocks the upload.
Fix
Log in to SmartestQA again in the same browser, then rescan the page. If a company proxy is used, ask IT to allow SmartestQA domains.
Many items are under “AI could not find a unique locator”Recording
Why
Repeated controls, such as an Edit button on every table row, look the same to the scan.
Fix
Untick them, then add the few you need by hand with a locator that includes the row’s distinguishing text.

Actions and locators#

Every recorded action shows XPath in amberLocators
Why
The chip colours by locator type, and recorders store XPath. See Locator chip.
Fix
No action needed if runs pass. For key controls, add an id or name locator in Action Detail. How the colour is decided: Locator chip.
Duplicate did not create a copyActions
Why
Same type, page, name and main locator means it is the same action, so the existing one is returned.
Fix
Change the name, the page or the locator before saving. See Duplicating.
I can’t delete an actionActions
Why
Either you are not an Admin or its creator (“You do not have permission to delete this action.”), or it is linked to test cases or data sources.
Fix
Ask an admin, or remove the action from the linked tests first. See Deleting.
I can’t clear Navigates To by double-clickingActions
Fix
Inline editing ignores empty values. Open the action with Edit and clear the field there.

App Map#

A page shows “Not on map” or left its moduleApp Map
Why
The page was renamed or created after the last Update map. Modules and map records follow the page name.
Fix
Run Update map, then move the page back to its module and re-scope its notes.
The “n unreachable” chip won’t go awayApp Map
Fix
Run Auto-fix (needs passing test runs), or set Navigates To on the action that leads to each listed page. One remaining page is accepted as the start page.
Update map warns that no passing test case was foundApp Map
Why
Without a passing test, the map cannot verify transitions or pick an entry page. In some versions this warning appears in Turkish: “Basarili kosusu olan case bulunamadi…”.
Fix
Run at least one test case successfully in a pipeline, then Update map again.
Error appMapScreenshotLimit when adding a screenshotApp Map
Why
A page can have at most 4 screenshots.
Fix
Remove one first, or use the role and state labels to keep the four most useful variants.

Mobile and desktop#

“Make sure Appium Server is running on http://localhost:4723” / “Could not start the session”Mobile
Check
  1. The agent is green in Test Agents.
  2. Appium Server is running on port 4723 on the same computer.
  3. The device or emulator is connected; package and activity (or bundle ID) are correct. See Configure the device.
  4. On Device Farm, your app is already installed on the device.
“No SmartTest-Desktop agent found” / “No agent is online”Desktop
Fix
Install and start the agent on the Windows or macOS computer with the app, and wait until it is green. See Install an agent.

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai