---
title: "Troubleshooting"
section: "Discover"
description: "Fixes for SmartestQA Discover: recording and the extension, locators and actions, the App Map, and mobile and desktop capture."
url: https://docs.smartestqa.ai/en/discover-troubleshooting.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "discover error problem fix extension start page url no actions found screenshots upload unique locator duplicate delete not on map appium desktop agent"
---
# Discover: Troubleshooting

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

## 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

### Problem: I don’t see the Discover Your App button _(Recording)_

- **Why:** It exists only in [WEB projects](https://docs.smartestqa.ai/en/quick-start-project.html#project-type). On [Setup Roadmap](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap) it is hidden when the roadmap’s Next card already offers it.
- **Fix:** Use **Action List** › **More** › [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step). In MOBILE and DESKTOP projects use [Record Actions](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#mobile) or the [Desktop Recorder](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop).

### Problem: 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](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension), press `F5` on the SmartestQA tab and try again. Details in [Quick Start](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-extension-not-detected).

### Problem: “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](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step), pick another [environment](https://docs.smartestqa.ai/en/concepts.html#environments), or add the URL with [**Manage URLs**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url).

### Problem: “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**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) again, or capture the few controls you need with [Record Actions](https://docs.smartestqa.ai/en/discover-your-app.html#record-actions) or [New Action](https://docs.smartestqa.ai/en/discover-actions.html#manual-action).

### Problem: “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](https://docs.smartestqa.ai/en/quick-start-account.html#step-2) in the same browser, then rescan the page. If a company proxy is used, ask IT to allow SmartestQA domains.

### Problem: 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](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) with a locator that includes the row’s distinguishing text.

## Actions and locators

### Problem: Every recorded action shows XPath in amber _(Locators)_

- **Why:** The chip colours by locator type, and recorders store XPath. See [Locator chip](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip).
- **Fix:** No action needed if runs pass. For key controls, add an `id` or `name` locator in [Action Detail](https://docs.smartestqa.ai/en/discover-actions.html#manual-action). How the colour is decided: [Locator chip](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip).

### Problem: Duplicate did not create a copy _(Actions)_

- **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](https://docs.smartestqa.ai/en/discover-actions.html#duplicate).

### Problem: I can’t delete an action _(Actions)_

- **Why:** Either you are not an [Admin](https://docs.smartestqa.ai/en/company-settings-roles.html) or its creator (“You do not have permission to delete this action.”), or it is linked to test cases or [data sources](https://docs.smartestqa.ai/en/data-source-variables.html#connected-actions).
- **Fix:** Ask an admin, or [remove the action from the linked tests](https://docs.smartestqa.ai/en/automate-editor.html#remove-step) first. See [Deleting](https://docs.smartestqa.ai/en/discover-actions.html#delete).

### Problem: I can’t clear Navigates To by double-clicking _(Actions)_

- **Fix:** [Inline editing](https://docs.smartestqa.ai/en/discover-actions.html#inline-edit) ignores empty values. [Open the action with Edit](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) and clear the field there.

## App Map

### Problem: A page shows “Not on map” or left its module _(App 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](https://docs.smartestqa.ai/en/discover-app-map.html#update-map), then [move the page back to its module](https://docs.smartestqa.ai/en/discover-app-map.html#modules) and [re-scope its notes](https://docs.smartestqa.ai/en/discover-notes.html#add-notes).

### Problem: The “n unreachable” chip won’t go away _(App Map)_

- **Fix:** Run [**Auto-fix**](https://docs.smartestqa.ai/en/discover-actions.html#unreachable) (needs passing test runs), or [set Navigates To](https://docs.smartestqa.ai/en/discover-actions.html#inline-edit) on the action that leads to each listed page. One remaining page is accepted as the start page.

### Problem: Update map warns that no passing test case was found _(App 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](https://docs.smartestqa.ai/en/quick-start-first-test.html#step-6), then [Update map](https://docs.smartestqa.ai/en/discover-app-map.html#update-map) again.

### Problem: Error `appMapScreenshotLimit` when adding a screenshot _(App Map)_

- **Why:** A page can have at most 4 screenshots.
- **Fix:** Remove one first, or use the [role and state labels](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) to keep the four most useful variants.

## Mobile and desktop

### Problem: “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](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).
  2. [Appium Server is running](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#android-emulator) on port 4723 on the same computer.
  3. The [device or emulator is connected](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#connected-devices); [package and activity (or bundle ID)](https://docs.smartestqa.ai/en/project-settings-mobile.html#local) are correct. See [Configure the device](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#mobile).
  4. On Device Farm, your app is [already installed on the device](https://docs.smartestqa.ai/en/agent-pool-app-library.html#install-on-devices).

### Problem: “No SmartTest-Desktop agent found” / “No agent is online” _(Desktop)_

- **Fix:** Install and start the agent on the [Windows](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#windows-desktop) or [macOS](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#macos-desktop) computer with the app, and [wait until it is green](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.html#fix-agent-offline). See [Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).
