---
title: "Discover Your App"
section: "Discover"
description: "Map a web application with Discover Your App: recording settings, scanning each page, the Review Actions window, how pages are named and what every scan creates."
url: https://docs.smartestqa.ai/en/discover-your-app.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "discover your app dom recorder scan page review actions page name start recording stop recording record actions locators screenshot"
---
# Discover: Discover Your App

Discover Your App opens your app in a new tab and scans each page you visit for its interactive controls. You review what it found, name the page and save.

## In short

**On this page you can**

- Scan a web app page by page for its interactive controls.
- Review what each scan found and untick controls you will never test.
- Name pages well, using the rules behind the suggested names.
- See what a scan creates: action types, names, locators, screenshots, App Map record.
- Use Record Actions to capture only the controls you use.

**How to use it**

1. Choose the environment and start page in the recording settings.
2. Click Discover Your App , open your first page and click Start Recording .
3. In Review Actions, check the Page name , untick noise and click Save Selected .
4. Move through the app; each new page or dialog is scanned by itself.
5. Click Stop Recording , then check Action List and App Map.

> **Note: You need**
>
> A [WEB project](https://docs.smartestqa.ai/en/quick-start-project.html#project-type), the SmartestQA extension in Chrome or Edge, a start page URL with an address for your environment, and a test user. Set these up in [Connect your app](https://docs.smartestqa.ai/en/quick-start-connect.html).

## Step by step

1. **Check the recording settings**

   Click the recording settings button (it shows the environment, for example **TEST · Login**). Choose the [**Environment**](https://docs.smartestqa.ai/en/concepts.html#environments) and the [**Start Page URL**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url). Use [**Manage URLs**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) to add one.
2. **Start Discover Your App**

   Click the purple **Discover Your App** button on [Setup Roadmap](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap), or **Action List** › **More** › **Discover Your App**. SmartestQA says “Recording started! Create actions in the new tab.” and opens your start page in a new tab, with a panel at the bottom right titled **Smartest · Discover Your App**.
3. **Go to the page and click Start Recording**

   Log in with your test user if needed and open the first page you want. Click **Start Recording** in the panel. The extension scrolls the page to load lazy content, then scans up to 400 interactive controls and works out locators for each.
4. **Review what was found**

   The **Review Actions** window lists “*n* actions found”. Check the **Page name** (it is required and suggested from the address), untick anything you will never test, and look at the two special groups below.
5. **Save Selected**

   Click **Save Selected**. The panel says “Page scanned! Navigate to other pages…”.
6. **Move on through the app**

   Open the next page. When the address changes, a new scan starts by itself after about a second. When you open a dialog, a tab or a menu that adds two or more new controls, only the new controls are scanned, under a derived page name.
7. **Stop Recording**

   Click **Stop Recording**. The tab closes and the [Action List](https://docs.smartestqa.ai/en/discover-actions.html#action-list) refreshes.

   Each page you saved has its actions in the Action List and a [record in the App Map](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) with its address, title and a screenshot.

- How many controls the scan found on this page.
- **Page name**: required. Suggested from the address; change it if a better name exists.
- **UPDATE**: controls already saved on this page. Saving updates them and keeps their page name.
- Controls with no unique locator, typical for repeated row buttons. Untick them or [fix them by hand later](https://docs.smartestqa.ai/en/discover-actions.html#inline-edit).
- **Save Selected** saves only ticked items.

## How pages are named

The suggested page name comes from the address. You can change it in the review window before saving.

| Address or screen change | Suggested page name | Rule |
| --- | --- | --- |
| `https://shop.example.com/` | `home` | The root path becomes `home`. |
| `/customer-orders/8812` | `customer_orders` | Lower case, hyphens become `_`, a trailing numeric ID is dropped. |
| `/admin/user-roles` | `admin/user_roles` | Path segments are joined with `/`. |
| Tab “Billing” opened on `settings` | `settings_`*billing* | Tabs add `_<label>`. |
| “Add user” button opens a dialog on `users` | `users_`*add_user*`_modal` | Open, add, create and edit triggers add `_<label>_modal`. |

> **Tip: Name pages the way your team talks**
>
> Page names are used in [requirements](https://docs.smartestqa.ai/en/analyze-requirements.html), AI prompts and [reports](https://docs.smartestqa.ai/en/report.html). `checkout` reads better than `shop/cart/step_2`. Rename in the review window, before the first save: once tests use a page, renaming it has [side effects](https://docs.smartestqa.ai/en/discover-actions.html#rename).

## What a scan creates

| Control on the page | Action type | Example name |
| --- | --- | --- |
| Button, link, element with a clickable role | [Click](https://docs.smartestqa.ai/en/automate-steps-browser.html#click) | `Click Submit Order` |
| Editable input or text area | [Type](https://docs.smartestqa.ai/en/automate-steps-browser.html#type) | `Type Email` |
| Read-only input | [Get](https://docs.smartestqa.ai/en/automate-steps-browser.html#get) | `Get Order Number` |
| Drop-down select | [Select](https://docs.smartestqa.ai/en/automate-steps-browser.html#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](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai), the AI improves the names; without AI you still get the plain names.
- **Locators:** up to three XPath locators, each with a [confidence score](https://docs.smartestqa.ai/en/discover-numbers.html#locator-chip), 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. Add, new and edit buttons that open a dialog get `<page>_modal`.
- **Screenshot:** one cropped screenshot per control with the control outlined. If cropping fails, the full page is used.
- **[App Map record](https://docs.smartestqa.ai/en/discover-app-map.html#page-information):** address, page title, number of controls and the main screenshot, marked as coming from the recorder.

## Record Actions instead of a full scan

**More** › **Record Actions** (“Record actions from browser”) captures only the controls you actually use while you click through the app, with a screenshot of each. Use it when a page has hundreds of controls and you need five, or when you want actions in the order of a real flow.

## If something goes wrong

- [I don’t see the Discover Your App button](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-discover-button-missing)
- [The Chrome Web Store opens instead of my app](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-extension)
- [“Please select a Start Page URL.”](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-select-start-url)
- [“No actions found on this page.”](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-no-actions-found)
- [“Screenshots could not be uploaded”](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-screenshots-upload)
- [Many items under “AI could not find a unique locator”](https://docs.smartestqa.ai/en/discover-troubleshooting.html#fix-no-unique-locator)
