---
title: "Discover"
section: "Discover"
description: "Discover is where SmartestQA learns your application: pages, controls (actions and locators), how pages connect (App Map) and the rules nobody can see on screen (Notes)."
url: https://docs.smartestqa.ai/en/discover.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "discover overview action list app map notes setup roadmap tabs capture methods"
---
# Discover

Discover is where SmartestQA learns your application: its pages, the controls on each page, how the pages connect, and the business rules nobody can see on screen. Analysis, AI test generation and every recorded step read from here.

## In short

**On this page you can**

- Learn what Discover captures: actions, App Map pages and Notes.
- Pick the right tab: Setup Roadmap, App Map, Notes or Action List.
- Check what you need first for a WEB, MOBILE or DESKTOP project.
- Choose a capture method, from Discover Your App to an MCP assistant.
- Follow the best practices that keep pages, locators and rules useful to the AI.

**How to use it**

1. Capture pages with Discover Your App (web), Record Actions (mobile) or Desktop Recorder .
2. Review the actions in Action List and fix names and locators.
3. Click Update map , then write a Purpose for at least 60% of pages.
4. Group pages into modules and add your business rules in Notes.
5. Check the Setup Roadmap, then move on to Analyze .

**At a glance**

- **Where:** Main menu › **Discover**, the first item. Tabs: [Setup Roadmap](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap), [App Map](https://docs.smartestqa.ai/en/discover-app-map.html), [Notes](https://docs.smartestqa.ai/en/discover-notes.html), [Action List](https://docs.smartestqa.ai/en/discover-actions.html#action-list).
- **Who:** Everyone in the project. [Deleting an action](https://docs.smartestqa.ai/en/discover-actions.html#delete) needs Admin or the action’s creator.
- **You need:** Web: the [browser extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension) and a [start page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url). Mobile and desktop: a [running agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).
- **Time:** Scanning a page takes seconds; reviewing its actions takes a minute or two.
- **Produces:** [**Actions**](https://docs.smartestqa.ai/en/discover-actions.html) (one per control, with locators and a screenshot), **App Map** pages and **Notes**.
- **Used by:** [Analyze](https://docs.smartestqa.ai/en/analyze.html), [AI test generation](https://docs.smartestqa.ai/en/analyze-import.html), [Automate steps](https://docs.smartestqa.ai/en/automate-steps.html), the Setup Roadmap and [AI assistants through MCP](https://docs.smartestqa.ai/en/mcp.html).
- **Project types:** WEB: [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html) and [**Record Actions**](https://docs.smartestqa.ai/en/discover-your-app.html#record-actions). MOBILE: [**Record Actions** (Appium inspector)](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#mobile). DESKTOP: [**Desktop Recorder**](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop). Manual [**New Action**](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) works everywhere.

## Start from your question

I want to…

- [Map my web app page by page](https://docs.smartestqa.ai/en/discover-your-app.html)
- [Capture a mobile or desktop app](https://docs.smartestqa.ai/en/discover-mobile-desktop.html)
- [Add a control by hand](https://docs.smartestqa.ai/en/discover-actions.html#manual-action)
- [Describe a page for the AI](https://docs.smartestqa.ai/en/discover-app-map.html#page-information)
- [Give the AI a business rule](https://docs.smartestqa.ai/en/discover-notes.html)

Something is wrong

- [The Web Store opens instead of my app](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-extension)
- [A scan found no actions](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-no-actions-found)
- [I can’t delete an action](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-cannot-delete)
- [A page shows “Not on map”](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-not-on-map)
- [All Discover problems](https://docs.smartestqa.ai/en/discover-troubleshooting.html)

How does it work?

- [Why my locator is amber](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip)
- [What the Cases number counts](https://docs.smartestqa.ai/en/discover-numbers.html#cases-badge)
- [How the roadmap percentage moves](https://docs.smartestqa.ai/en/discover-numbers.html#roadmap-math)
- [Which notes the AI receives](https://docs.smartestqa.ai/en/discover-notes.html#notes-to-ai)
- [What renaming a page changes](https://docs.smartestqa.ai/en/discover-actions.html#rename)

## Where Discover fits

The main menu is the order of work. Discover comes first because everything after it builds on what it knows.

1. **Discover** — Pages, controls, rules ← this page
2. **Analyze** — Requirements from the map
3. **Automate** — Test cases from actions
4. **Schedule** — Pipelines
5. **Report** — Results
6. **Maintenance** — Heal and review

## Why spend time here

- **AI writes tests about your app, not a generic one.** When AI [analyses requirements](https://docs.smartestqa.ai/en/analyze-assessment.html) or [generates tests](https://docs.smartestqa.ai/en/automate-ai.html#generate-test-cases), it receives each page’s purpose, preconditions, expected outcomes, risk, roles, what can be done there, where it leads, and [your notes](https://docs.smartestqa.ai/en/discover-notes.html#notes-to-ai). Without them it falls back to a text search over all actions and the tests come out generic.
- **One control, many tests.** A test step points at an action by its ID. [Fix a locator once](https://docs.smartestqa.ai/en/discover-actions.html#inline-edit) and every test that uses the action is fixed.
- **Several ways to find each control.** Recorded actions keep up to three locators with a confidence score each, so a run can [fall back when one stops matching](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html).
- **You can see what is untested.** The App Map’s [**Tested** column](https://docs.smartestqa.ai/en/discover-numbers.html#tested-coverage) shows, per page, how much of what users can do there is covered by a test.
- **Your rules are applied everywhere.** A [note](https://docs.smartestqa.ai/en/discover-notes.html) such as “Orders over €10,000 need a second approver” reaches every AI generation for the pages it applies to.

> **Warning: If you skip Discover**
>
> [Recording in Automate](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web) still creates actions, so tests work. What you lose is context: the [Setup Roadmap](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap) stays on **Describe the app**, the App Map has [no purposes](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) or coverage, and AI-generated requirements and tests know only the names of controls.

## The building blocks

- **Action:** One control on one page, for example `Click Sign In` on page `login`. It has a [type (Click, Type, Get…)](https://docs.smartestqa.ai/en/automate-steps-browser.html), one or more locators, an optional **Navigates To** page and a screenshot.
- **Page:** A name that groups actions, such as `checkout`. Pages are created by naming them; there is no separate “create page” step.
- **Locator:** [How the test finds the control](https://docs.smartestqa.ai/en/automate-steps-browser.html#finding-elements): `id`, `name`, `css`, `xpath`, `accessibility_id`, `resource-id`, `class`, `linktext` or `tagname`.
- **Navigates To:** The page an action leads to. `Click Sign In` → `dashboard`. These links draw the [App Map](https://docs.smartestqa.ai/en/discover-app-map.html).
- **App Map page:** The [description of a page](https://docs.smartestqa.ai/en/discover-app-map.html#page-information): purpose, preconditions, expected outcomes, risk, roles, screenshots, tasks and transitions.
- **Module:** A group of pages that belong to one business area, for example **Orders**. [Analyze creates one requirement folder per module](https://docs.smartestqa.ai/en/analyze-folders.html#modules).
- **Note:** One fact about the app that no scan can find, such as a role rule or a data precondition. [Notes are sent to the AI](https://docs.smartestqa.ai/en/discover-notes.html#notes-to-ai).
- **Start page URL:** [Where recording begins](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url), with a URL per [environment](https://docs.smartestqa.ai/en/concepts.html#environments) (DEV, TEST, PRP).

## The screen

Discover has four tabs. It opens on the tab in the address (`?tab=roadmap`, `map`, `notes` or `actions`), otherwise the last tab you used, otherwise Setup Roadmap. Once setup is complete it opens on Action List.

![Discover › Action List.](https://docs.smartestqa.ai/media/shots/DSC-SHOT-01.png)

- **Tabs**: Setup Roadmap, App Map, Notes, Action List.
- **Recording settings** (web): environment and start page used by [Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step). A warning icon means no start page is selected.
- **New Action**: [create an action by hand](https://docs.smartestqa.ai/en/discover-actions.html#manual-action).
- **More** (web): [**Record Actions**](https://docs.smartestqa.ai/en/discover-your-app.html#record-actions) and **Discover Your App**.
- **Module** filter: All, Unassigned, or [one module](https://docs.smartestqa.ai/en/discover-app-map.html#modules). Narrows the page pills.
- **Page pills**: one per page, with its number of actions.
- **Unreachable**: [pages no action leads to](https://docs.smartestqa.ai/en/discover-actions.html#unreachable). Click to see them.
- **Auto-fix**: fills missing Navigates To from passing test runs.
- **Last-run status** of the action: passed, failed, never run.
- **Locator chip**: the main locator’s type, the number of fallbacks, and [colour by type](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip).
- **Cases**: [how many test cases use this action](https://docs.smartestqa.ai/en/discover-numbers.html#cases-badge). Click to list them.

| Tab | What it is for | Go there when |
| --- | --- | --- |
| Setup Roadmap | [Eight-step progress](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap) of the whole project, with the next thing to do. Web projects get the [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) button here. | You start a project or don’t know what to do next. |
| App Map | [Every page as a record](https://docs.smartestqa.ai/en/discover-app-map.html): what it is for, its screenshots, where it leads, how well it is tested, which module it belongs to. | You describe pages, build modules, check coverage. |
| Notes | [Rules and facts for the AI](https://docs.smartestqa.ai/en/discover-notes.html), one per note. | You know something about the app that a scan cannot see. |
| Action List | [All actions in a searchable table](https://docs.smartestqa.ai/en/discover-actions.html#action-list). | You edit, fix or clean up controls and locators. |

## Before you start

| Project type | You need | Check it |
| --- | --- | --- |
| WEB | The SmartestQA [extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension) in Chrome or Edge; a [start page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) with an address for the environment you will use; a test user. | Open the [recording settings](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step): the environment and start page are filled and there is no warning icon. |
| MOBILE | The agent running on this computer; [Appium Server](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#android-emulator) on `http://localhost:4723` with a device or emulator, or a [SmartTest Device Farm device](https://docs.smartestqa.ai/en/agent-pool-devices.html#devices) with your [app installed](https://docs.smartestqa.ai/en/agent-pool-app-library.html#install-on-devices). | The host is [green in Device Farm › Test Agents](https://docs.smartestqa.ai/en/agent-pool-agents.html#agent-status). |
| DESKTOP | The agent running and online 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. | The host is green in Device Farm › Test Agents. |

New to these? [Quick Start, step 4](https://docs.smartestqa.ai/en/quick-start-connect.html) sets them up.

## Ways to capture your app

| Method | Best when | You get |
| --- | --- | --- |
| [Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.html) | Mapping many web pages fast | All interactive controls per page, locators, screenshots, an App Map record |
| [Record Actions (More menu)](https://docs.smartestqa.ai/en/discover-your-app.html#record-actions) | A page has many controls and you need a few | Only the controls you use, in flow order |
| [Record in Automate](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web) | You want the test and its actions in one go | A test case plus the actions its steps use |
| [New Action](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) | You know the locator; the control is hard to reach | One precise action |
| [Appium inspector / Desktop Recorder](https://docs.smartestqa.ai/en/discover-mobile-desktop.html) | Mobile and desktop apps | Actions with platform locators and screenshots |
| [AI assistant through MCP](https://docs.smartestqa.ai/en/mcp.html) | Developers working from source code | The assistant [reads the map and writes actions and page descriptions](https://docs.smartestqa.ai/en/discover-faq.html#mcp) |

Outside SmartestQA, teams keep page objects in code or locator spreadsheets. Those work, but they are not shared with the AI, they have no usage counts, and every locator change is a code change.

## Best practices

#### Do

- Start with the pages of your three most important user flows.
- [Name pages before the first save](https://docs.smartestqa.ai/en/discover-your-app.html#page-names), the way the business talks.
- Write a [Purpose](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) for at least 60% of pages.
- Put critical business rules in [Notes](https://docs.smartestqa.ai/en/discover-notes.html#add-notes), one rule per note.
- [Add an `id` or `name` locator](https://docs.smartestqa.ai/en/discover-actions.html#inline-edit) where the app has one.
- Run [Update map](https://docs.smartestqa.ai/en/discover-app-map.html#update-map) after big recording sessions and after renames.
- Record on [TEST](https://docs.smartestqa.ai/en/concepts.html#environments) with a test user.

#### Don’t

- Save every control of every page “just in case”. [Untick noise in review](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step).
- Keep two pages for the same screen under different names.
- [Rename pages](https://docs.smartestqa.ai/en/discover-actions.html#rename) casually once tests and notes use them.
- Use [Delete Anyway](https://docs.smartestqa.ai/en/discover-actions.html#delete) on widely used actions.
- Write purposes that only repeat the page name.
- Record with production data: screenshots are stored with every action.

## In this section

- [Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.html) — Scan a web app page by page: settings, the review window, page names and what each scan creates.
- [Mobile & desktop](https://docs.smartestqa.ai/en/discover-mobile-desktop.html) — Capture Android, iOS and desktop apps with the Appium inspector and the Desktop Recorder.
- [Actions](https://docs.smartestqa.ai/en/discover-actions.html) — Create and edit actions, find them in the Action List, and rename, copy or delete them safely.
- [App Map](https://docs.smartestqa.ai/en/discover-app-map.html) — Build the map with Update map, describe each page, and group pages into modules.
- [Notes](https://docs.smartestqa.ai/en/discover-notes.html) — Write the rules and facts the AI cannot see, and control which notes reach it.
- [How the numbers work](https://docs.smartestqa.ai/en/discover-numbers.html) — Formulas and worked examples for the locator chip, Cases, the roadmap percentage and App Map coverage.
- [Troubleshooting](https://docs.smartestqa.ai/en/discover-troubleshooting.html) — Every Discover message and symptom, with why it happens, what to check and how to fix it.
- [FAQ, MCP & limits](https://docs.smartestqa.ai/en/discover-faq.html) — Questions and answers, AI assistant use and the module’s limits.

## Related

- [Connect your app](https://docs.smartestqa.ai/en/quick-start-connect.html): extension, start page URL and agent before you capture.
- [Analyze](https://docs.smartestqa.ai/en/analyze.html): turn modules and pages into requirements.
- [Record and add steps](https://docs.smartestqa.ai/en/automate-add-steps.html): build test cases from your actions.
- [Auto-heal reviews](https://docs.smartestqa.ai/en/maintenance-auto-heal.html): locator repairs proposed after failed runs.
- [MCP & AI assistants](https://docs.smartestqa.ai/en/mcp.html): let a code assistant map pages and write actions.
- [Core concepts: app knowledge](https://docs.smartestqa.ai/en/concepts.html#app-knowledge): how actions, pages and notes fit together.
