> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a product map

> Use the AI mapping agent to build and maintain a structured coverage map of your application's user journeys.

A coverage map defines the scope required to test an application end-to-end. Without visibility into an application's surface area — key user paths, important states, and system boundaries — it's difficult to know whether coverage is complete or where it isn't.

The AI mapping agent creates and maintains a structured view of coverage by exploring your application and generating flow stubs that represent the main areas and user journeys. As features change or new ones are added, you can run the agent again to update the map.

<Frame>
  <iframe src="https://fast.wistia.net/embed/iframe/9zdx3ui806" title="Wistia video player" allowFullScreen style={{ width: "100%", aspectRatio: "16/9", border: "none" }} />
</Frame>

## Start a mapping session

<Steps>
  <Step>
    From the **Map** tab, click **New Flows** on the right side of the screen, or click the <Icon icon="plus" /> icon in the left sidebar and select **Mapping session**.

    <Frame>
      <img src="https://mintcdn.com/qawolf/zXwzvDJEk-vr7IQd/images/map-home-page.png?fit=max&auto=format&n=zXwzvDJEk-vr7IQd&q=85&s=51eaba1f74c4cc2b4127f68becc49df5" alt="Map tab home" width="1554" height="458" data-path="images/map-home-page.png" />
    </Frame>
  </Step>

  <Step>
    A new mapping session opens with a live browser panel in the center. The agent will ask you to confirm the URL you want to explore, or you can type your own instructions into the chat box.

    <Frame>
      <img src="https://mintcdn.com/qawolf/WhusTdYQKIe4Ucwh/images/mapping-session.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=067cd345d8305cda217579c4e2fa23f3" alt="Mapping Session" width="2890" height="1806" data-path="images/mapping-session.png" />
    </Frame>
  </Step>

  <Step>
    Type a description of what you want to map. For example: *"Create a test plan for `https://yourapp.com`"*. You can specify a base URL, describe a specific journey, or ask the agent to focus on a particular feature area.
  </Step>

  <Step>
    Provide real-time guidance as the agent works. If the agent encounters a login prompt or needs clarification, it will ask you directly in the chat. You can respond at any time to redirect or refine the exploration.
  </Step>
</Steps>

## Map from a file

Click <Icon icon="plus" /> in the chat input to attach a file, then use one of the following prompts depending on what you want.

<Note>
  Supported file types: CSV, JSON, Markdown, plain text, and YAML.
</Note>

### Generate flows from a file

Parses the file and creates the folder structure and flow stubs immediately, without exploring the app. Supports most file and image types.

Prompt: *"Upload the flows from this file."*

### Map your app using a file as a guide

Uses the file as a reference while the agent actively explores your app.

<Steps>
  <Step>
    Navigate to your app in the browser panel, or include the URL and login credentials in your message.
  </Step>

  <Step>
    Prompt: *"Map all the flows in this file."*
  </Step>
</Steps>

When the session ends, the agent produces a CSV with each test case's coverage status, the flow that covers it, and the reason for any rejections.

## Review and publish mapped flows

As the agent maps your application, newly discovered flows appear in the right panel. Review them before publishing.

<Steps>
  <Step>
    Review the flows in the **New** tab on the right panel. These are the flow stubs the agent has created.

    <Frame>
      <img src="https://mintcdn.com/qawolf/WhusTdYQKIe4Ucwh/images/map-new-flows-discovered.png?fit=max&auto=format&n=WhusTdYQKIe4Ucwh&q=85&s=66d347e7505a68b4ef9e707debf42529" alt="Map New Flows Discovered" width="2898" height="1800" data-path="images/map-new-flows-discovered.png" />
    </Frame>
  </Step>

  <Step>
    When satisfied, click **Publish** to add the flows to your coverage map. This creates the folder structure and empty flow files in the Automate tab.

    <Note>
      Publishing during mapping creates folder structure and empty flow stubs automatically. You don't need to review and publish manually — this happens as part of the mapping process.
    </Note>
  </Step>
</Steps>

## Continue or revisit a mapping session

Previous mapping sessions are saved and accessible from the left sidebar. Click any session to reopen it and continue the conversation or review what was mapped.

To find more flows in an area that's already been mapped, type instructions into the chat or click **Find more flows** at the bottom of the chat panel.

## After mapping

Once published, your flows appear in the **Flows view** on the **Map** tab. From there, you can:

* Review run status across all flows — see [Reviewing run results](/qawolf/Interpret-run-results-2d55b2a994fb80199754e4b2d3ce0318)
* Run flows manually — see [How runs work](/qawolf/Run-a-flow-or-suite-2a25b2a994fb8014b164d7ad2efd5ddel)
* Apply tags and manage readiness — see [Use tags effectively](/qawolf/Use-tags-effectively-2c35b2a994fb809abbd7ea9402738bdb)
* Open a flow in the editor to write or edit code — see [Create a new flow](/qawolf/Create-a-new-flow-2c15b2a994fb802193a5c05e0219eb59)
