---
title: "How does SmartestQA learn what my application looks like?"
section: "Use cases"
description: "How SmartestQA maps an application: Discover Your App scans up to 400 controls per page into actions with locators and screenshots, the Action List holds them, and the App Map records each page's purpose, transitions, modules and test coverage."
url: https://docs.smartestqa.ai/en/use-case-app-map.html
audience: [customer, admin]
updated: 2026-11-12
keywords: "app map application map action list discover your app scan page elements locators page object repository object repository crawl application model ai understands my app application knowledge element recorder page purpose modules test coverage per page navigates to application knowledge vs wiki vs page objects in scripts which pages have no test delivery app example locators in one place"
---
# Use cases: How does SmartestQA learn what my application looks like?

SmartestQA learns your application in Discover: Discover Your App opens your app in a new tab and scans each page you visit for its interactive controls, and you review and save them as actions. The Action List holds every action with its locators, and the App Map describes each page: what it is for, where it leads and how well it is tested.

## In short

**On this page you can**

- Scan a web page into actions: one per control, with locators and a screenshot.
- See every page as a record with its purpose, module, transitions and screenshots.
- Find and fix controls and locators in one searchable Action List.
- See per page how much of what users can do there is covered by a test.
- Give the AI what it needs to write requirements and tests about your app.

**How to use it**

1. Open Discover and click Discover Your App on Setup Roadmap.
2. In the new tab, open a page and click Start Recording .
3. Check the Page name in Review Actions and click Save Selected .
4. Go through the other pages, then click Stop Recording .
5. In App Map, click Update map, then write a Purpose for each page under Detail .

## The short answer

You show SmartestQA the application in **Discover**, the first item of the main menu. In a web project, [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) opens your start page in a new tab; on each page you visit, the browser extension scans up to 400 interactive controls and works out locators for each. You review the list, name the page and save.

What it keeps has two views. The **Action List** holds every action: one control on one page, with a type, one or more locators, an optional Navigates To page and a screenshot. The **App Map** holds every page as a record: its purpose, preconditions, expected outcomes, risk, roles, screenshots, tasks and transitions. Analyze, AI test generation, Automate steps and AI assistants through MCP all read from here.

## The problem this solves

In many teams, what is known about the application is spread out. The locators sit inside test scripts. The description of each page sits in a shared document that is often out of date. Which pages have a test is kept in a spreadsheet, or in someone’s head.

That hurts in three places. The same button is located in several scripts, so one change in the page means several edits. Nobody can say quickly which pages have no test. And an AI that is asked to write tests knows nothing about the application, so it writes general steps. What is missing is one record of the pages and controls that tests, people and the AI all read.

## An example

This is an illustration, not a customer story. A team tests the web back office of a delivery app, and a tester starts with the three pages dispatchers use most.

1. The tester chooses the Environment and the Start Page URL and clicks [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step): “Recording started! Create actions in the new tab.”
2. The tester logs in with a test user, opens the orders page and clicks [**Start Recording**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step). The Review Actions window lists “38 actions found”. The tester checks the **Page name**, unticks the footer links and clicks [**Save Selected**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step): “Page scanned! Navigate to other pages…”
3. The tester opens the order detail page and the courier page. Each time the address changes, a new scan starts by itself. Then the tester clicks [**Stop Recording**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step), and the Action List refreshes.
4. In App Map the tester clicks Update map. The preview shows Pages to create and Transitions to create. The tester applies it: “Map updated”.
5. Under **Detail** the tester writes a Purpose for each page, and adds a business rule about late orders as a note, one rule per note.
6. After the first tests pass, the Tested column shows per page how much of what users can do there is covered by a test.

The team now has one list of controls that every test points at, and a page list that shows where tests are missing.

## A shared document, page objects in your own scripts, and SmartestQA

| Question | A shared document | Page objects in your own scripts | SmartestQA |
| --- | --- | --- | --- |
| Who collects the controls of a page? | Nobody; the document describes pages in words | A developer, one locator at a time | The scan, on each page you visit, up to 400 controls per page; you review and save |
| Where does a locator live? | Not in the document | In code, which works well when one team owns all scripts | On the action in the Action List; a step points at the action by its ID |
| What happens when a control changes? | Someone updates the text, if they remember | You edit the page object, and each copy of the locator | Fix the locator once and every test that uses the action is fixed |
| Who writes what a page is for? | A person | Usually nobody; code comments at most | A person, under **Detail**; later Update map runs do not overwrite those text fields |
| Which pages have no test? | Kept by hand, if at all | You search the scripts | The Tested column shows it per page |
| What does an AI get when it writes tests? | The document, if you paste it | The code, if it can read the repository | Each page’s purpose, what can be done there, where it leads, and your notes |

## Steps

1. **Have the basics ready**

   A WEB project needs the SmartestQA extension in Chrome or Edge, a start page URL with an address for your environment, and a test user. See [Connect your app](https://docs.smartestqa.ai/en/quick-start-connect.html). Mobile and desktop apps are captured through a running agent; see [Mobile and desktop capture](https://docs.smartestqa.ai/en/discover-mobile-desktop.html).
2. **Start Discover Your App**

   Click the recording settings button and choose the Environment and the Start Page URL. Then click the purple [**Discover Your App**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) button on Setup Roadmap, or **Action List** › **More** › **Discover Your App**.

   “Recording started! Create actions in the new tab.” Your start page opens in a new tab, with a panel at the bottom right.
3. **Scan a page**

   Log in with your test user if needed, open the first page you want and click [**Start Recording**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) in the panel. The extension scrolls the page to load lazy content, then scans the controls.
4. **Review and save**

   The Review Actions window lists “n actions found”. Check the **Page name** (required, suggested from the address), untick anything you will never test, and click [**Save Selected**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step). See [How pages are named](https://docs.smartestqa.ai/en/discover-your-app.html#page-names).

   “Page scanned! Navigate to other pages…”
5. **Move on through the app**

   Open the next page. When the address changes, a new scan starts by itself after about a second. A dialog, a tab or a menu that adds two or more new controls is scanned on its own, under a derived page name. Click [**Stop Recording**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) when you are done; the tab closes and the Action List refreshes.
6. **Update the map**

   In App Map, click Update map. A preview shows Pages to create, Pages to update, Transitions to create and more. Apply it. The map builds pages from all actions and transitions from the step order of every test case. See [Update map](https://docs.smartestqa.ai/en/discover-app-map.html#update-map).

   “Map updated”.
7. **Describe the pages**

   Click **Detail** on a page and fill Purpose, Preconditions, Expected outcomes, Risk and Roles. A good purpose names the user, the decision and the consequence. Your edits are protected: later Update map runs do not overwrite those text fields. See [Describe a page](https://docs.smartestqa.ai/en/discover-app-map.html#page-information).
8. **Group pages and add what no scan can see**

   Move pages into modules with [**Add new module**](https://docs.smartestqa.ai/en/discover-app-map.html#modules) and the module drop-down on the row. Put business rules in Notes, one rule per note; notes are sent to the AI. See [Group pages into modules](https://docs.smartestqa.ai/en/discover-app-map.html#modules) and [Notes](https://docs.smartestqa.ai/en/discover-notes.html).

## What a scan creates

| Control on the page | Action type | Example name |
| --- | --- | --- |
| Button, link, element with a clickable role | Click | Click Submit Order |
| Editable input or text area | Type | Type Email |
| Read-only input | Get | Get Order Number |
| Drop-down select | Select (by visible text) | Select Country |

- **Name:** a verb plus the control’s visible label, at most 60 characters. When the project’s AI is on, the AI improves the names.
- **Locators:** up to three XPath locators, each with a confidence score, or one CSS locator for controls inside a shadow DOM. Locators built on dynamic IDs, or that match more than one element, or that match nothing, are dropped.
- **Navigates To:** filled in for links within the same site.
- **Screenshot:** one cropped screenshot per control with the control outlined.
- **App Map record:** address, page title, number of controls and the main screenshot.

## How the App Map reads a page

| What you see | How it is decided |
| --- | --- |
| Verified | A page or transition seen in a passing test. |
| Declared | A page or transition known only from Navigates To. |
| Orphan | A page with neither. |
| Entry page | The first page of the most passing test cases. |
| Tested | Covered test points ÷ test points. Test points are the tasks on the page, its validation actions and the transitions leaving it. |
| Map colour | ≥ 80% green · 40–79% amber · < 40% red |
| “n unreachable” | Visible pages that no action leads to, shown only when there are 2 or more. |
| Cases | The number of distinct test cases with a step that uses the action directly. |

Example: `checkout` has 3 tasks, 2 validation actions and 2 transitions, so 7 points. Tests use the proof actions of 5 of them: 5 ÷ 7 = 71%, amber. Every formula is in [How the numbers work](https://docs.smartestqa.ai/en/discover-numbers.html).

## Watch it

The video shows the two results: the App Map with its modules, the page list, **Detail**, the Map view and Update map, then the Action List with its page pills, column filters, the unreachable chip and Auto-fix. It does not show the scan itself, Discover Your App.

Video: [Discover](https://docs.smartestqa.ai/media/videos/MOD-DISCOVER.mp4) (1:07)

The App Map and the Action List: what SmartestQA knows about your app.

Video transcript: The App Map is what the AI knows about your app: its pages, what you can do on each, and how they connect. On the left, pages are grouped into modules. Generating tests for a module uses only its pages. The list shows each page with its module and what can be done there. Detail opens the description of one page. Map draws the same pages as a graph, with the links between them. Update map rebuilds it from the actions Discover recorded. The Action List holds every action Discover recorded: the building blocks of your test steps. The page pills filter the list to one page of your application. Each column has its own filter: page name, action name, where it navigates to, and type. A row shows the action, its type, its locator, and in Cases how many test cases use it. The unreachable chip counts pages that no recorded action leads to. Auto-fix proposes the missing links. Edit, Duplicate and Delete are at the end of each row.

## What you get

- **One control, many tests.** A test step points at an action by its ID. Fix a locator once 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.
- **AI that writes about your app.** When AI analyses requirements or generates tests, it receives each page’s purpose, preconditions, expected outcomes, risk, roles, what can be done there, where it leads, and your notes.
- **A view of what is untested.** The App Map’s Tested column shows, per page, how much of what users can do there is covered by a test.
- **Usage counts.** The Cases badge shows how many test cases use an action; click it to list them.
- **Modules shared across screens.** A module groups pages of one business area, and Analyze creates one requirement folder per module.

## Questions and answers

### Q: Do I have to map every page of my application?

No. Start with the pages of your three most important user flows. The Setup Roadmap counts Describe the app as done when 60% of the pages you have mapped have a purpose. See [Setup Roadmap · Describe the app](https://docs.smartestqa.ai/en/discover-numbers.html#roadmap-math).

_Audience: customer, admin_

### Q: Does SmartestQA crawl my application by itself?

Discover Your App scans the pages you visit: you open a page in the recording tab, and when the address changes a new scan starts by itself. You review what was found and save it page by page. See [Step by step](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step).

_Audience: customer, admin_

### Q: Can it scan pages behind a login?

Yes. Log in in the tab Discover Your App opens, then click [**Start Recording**](https://docs.smartestqa.ai/en/discover-your-app.html#step-by-step) on each page. Use a test user and test data, because a screenshot is stored with every action. See [Can I scan pages behind a login?](https://docs.smartestqa.ai/en/discover-faq.html#faq-login)

_Audience: customer, admin_

### Q: Does the scan need AI?

No. The scan and the locators work without AI. When the project’s AI is on, it improves the action names, and Update map can let the AI fill “What can be done here”, up to 60 pages per batch. See [Does Discover Your App need AI?](https://docs.smartestqa.ai/en/discover-faq.html#faq-ai-required)

_Audience: customer, admin_

### Q: What does a scan store, and where does the data go?

The scan runs in the browser extension on your computer. It stores the controls, their locators and a screenshot of each control in your SmartestQA project. When AI is on, control labels are sent to the configured AI provider to name actions. See [What data does a scan store or send?](https://docs.smartestqa.ai/en/discover-faq.html#faq-data)

_Audience: customer, admin_

### Q: Does it work for mobile and desktop applications?

Yes, with other recorders. Discover Your App is for WEB projects. MOBILE projects use Record Actions with the Appium inspector, and DESKTOP projects use the Desktop Recorder; [**New Action**](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) works everywhere. See [Mobile capture](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#mobile).

_Audience: customer, admin_

### Q: If I rename a page or an action, do my tests break?

No. Steps point at actions by ID, not by name. A renamed page leaves its module and shows Not on map until you run Update map, and notes scoped to the old name need a new scope. See [Renaming a page or an action](https://docs.smartestqa.ai/en/discover-actions.html#rename).

_Audience: customer, admin_

### Q: Why do my recorded actions show XPath in amber?

The locator chip is coloured by the type of the main locator, and the web recorder stores its locators as XPath. The recorder has already rejected dynamic and non-unique locators. Judge a recorded action by its last-run status and confidence, and add an id or name locator by hand where one exists. See [Locator chip](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip).

_Audience: customer, admin_

### Q: What happens if I skip Discover and only record tests?

Recording in Automate still creates actions, so tests work. What you lose is context: the App Map has no purposes or coverage, and AI-generated requirements and tests know only the names of controls. See [Why spend time here](https://docs.smartestqa.ai/en/discover.html#why).

_Audience: customer, admin_

### Q: Can an AI assistant read or fill the App Map?

Yes. An assistant connected through the SmartestQA MCP server reads Discover with the `smartest_discover` tool, can create or update actions with `smartest_action_write` and can fill page tasks. See [For AI assistants (MCP)](https://docs.smartestqa.ai/en/discover-faq.html#mcp).

_Audience: customer, admin_

## Read more

- [Discover](https://docs.smartestqa.ai/en/discover.html): the four tabs, the building blocks and best practices.
- [What a scan creates](https://docs.smartestqa.ai/en/discover-your-app.html#what-gets-created): names, locators, screenshots and the App Map record.
- [App Map](https://docs.smartestqa.ai/en/discover-app-map.html): Update map, page information and modules.
- [Work with the Action List](https://docs.smartestqa.ai/en/discover-actions.html#action-list): filters, editing in place, unreachable pages and Auto-fix.
- [Limits](https://docs.smartestqa.ai/en/discover-faq.html#limits): 400 controls per scan, 4 screenshots per App Map page and the rest.
- [Core concepts: app knowledge](https://docs.smartestqa.ai/en/concepts.html#app-knowledge): how actions, pages and notes fit together.
- [How do I prove every requirement is tested?](https://docs.smartestqa.ai/en/use-case-coverage.html): coverage by requirement instead of by page.
