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

# Projects

> Keep every product, execution, and report organized with multi-project workspaces.

Projects group explorations, personas, and reports by product so fast-moving teams can keep quality work focused. Each project lives inside a workspace and comes with its own dashboard, execution history, and settings.

## Navigate with the project switcher

* Open the project switcher from the global navigation to jump between products without leaving the page you are on.
* Create a new project whenever you need coverage for another environment, brand, or major feature area.
* Scout remembers your last selection so relaunching an exploration always starts in the right context.

<img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-list.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=2d16bf90a1ff36d318134609e8005654" alt="Project list and recent executions" width="1" height="1" data-path="images/project-list.png" />

## Project dashboards

Project dashboards surface the current health of a product and provide one-click access to new runs.

<img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-dashboard.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=285b3c5066519fcdf0ce7934d0dbf1aa" alt="Project dashboard overview" width="2199" height="1243" data-path="images/project-dashboard.png" />

### Key capabilities

* Launch fresh explorations directly from the dashboard.
* Review a summarized activity feed before diving into a specific execution.
* Track completion status, duration, and personas for recent runs.

### Execution controls

* Search executions by URL or run title to find prior coverage quickly.
* Filter by status—completed, running, queued, failed, or canceled—to focus on the work that matters now.
* Rerun prior executions with a single click or share read-only results via `/t/{executionId}` links.

## Project settings

Use the settings tab inside a project to keep metadata accurate and clean up stale work.

<ResponseField name="Project name" type="string" required>
  Update the name shown in navigation and reports. Great for differentiating staging versus production projects.
</ResponseField>

<ResponseField name="Base URL" type="url" required>
  Set or adjust the primary domain Scout should explore. Changing the URL triggers automatic metadata refresh.
</ResponseField>

<ResponseField name="Branding" type="image">
  Upload a logo if you want to override the favicon and title that Scout fetched automatically.
</ResponseField>

<Note>
  Removing a project deletes its executions and reports. Export anything you need before proceeding.
</Note>

## Automated metadata

Scout fetches titles, descriptions, and favicons for you during onboarding and whenever you update a project's base URL. If you need the same enrichment in other systems, call the `/api/v1/meta` endpoint to retrieve the metadata programmatically.

<img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-create.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=65b86cd293369b44cac6c0d10212fb7c" alt="New project modal capturing URL input" width="1" height="1" data-path="images/project-create.png" />

## Best practices

* Create separate projects for each major surface area (marketing site, app, admin) so dashboards stay focused.
* Use the status filters to keep an eye on runs that are still in progress before big launches.
* Duplicate high-signal executions into new missions when you discover a regression worth tracking.
* Schedule regular reviews of project settings to retire old environments and keep navigation tidy.
