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

# Welcome

> What Surfaced does, and where to start.

Surfaced tracks how AI assistants answer the questions your buyers ask, and shows where your brand is named, where a competitor is named instead, and which pages the assistants cite when they answer.

If you are setting up a workspace for the first time, start with the [Quickstart](https://docs.getsurfaced.ai/quickstart.md). If you already have results and want to know what a number means, start with [Metrics](https://docs.getsurfaced.ai/metrics/overview.md).

## How it works

You give Surfaced a set of prompts: the questions a buyer would type. Surfaced asks them of the assistants on a schedule, reads the answers, and records three things each time: whether you were named, who else was named, and which pages were cited as the source.

That record is what every screen in the app is built on. Nothing is modelled or estimated from search volume; a number in Surfaced is a count of answers that came back.

> [card] [Set up a workspace](https://docs.getsurfaced.ai/set-up/workspace.md)
>
> Your brand, the markets you sell in, and the prompts you want watched.

> [card] [Read your results](https://docs.getsurfaced.ai/insights/analytics.md)
>
> Where you appear, where you don't, and how that is moving.

> [card] [Act on a gap](https://docs.getsurfaced.ai/improve/actions.md)
>
> Turn a prompt you lose into a page that answers it.

> [card] [Publish](https://docs.getsurfaced.ai/publish/hosted-blog.md)
>
> Write and ship the page, then watch whether it gets cited.

## If you only read one thing

The number most people want on day one is whether they are being recommended. That lives in [Metrics](https://docs.getsurfaced.ai/metrics/overview.md), which defines each figure and shows the calculation, so you can tell the difference between being absent from an answer and being absent from the data.

> [!NOTE]
>
> Results need a few days of answers before a trend means anything. One run tells you what one assistant said once.

## Getting help

Every page in the app has an info dot that links back here. If something is still unclear, [Troubleshooting](https://docs.getsurfaced.ai/troubleshooting/faq.md) covers the questions support gets most, and the Assistant in the top bar of this site will answer from these pages.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.