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

# Reports

> Turn an Analysis arrangement — or any figure, file, or note — into a saved, shareable document.

A Report is a freeform document built from **segments**: headings, text, device notes, embedded files/images, and live plots. Think of it as the place a working Analysis session graduates to once it's worth keeping.

## Building a report

<Steps>
  <Step title="Create or open a report">
    From the **Reports** tab, create a new report and give it a name.
  </Step>

  <Step title="Add content as you find it">
    Wherever you see a **+ Report** button — on a figure in an experiment's Images tab, on a file, on a chart you've built in Analysis — clicking it adds that item as a segment. If a report is already open, it's added directly; otherwise you're prompted to pick or create one.
  </Step>

  <Step title="Arrange and annotate">
    Add headings and text segments to give the report structure and explain what the reader is looking at. Segments can be reordered and resized.
  </Step>
</Steps>

## Segment types

| Segment       | What it holds                                                                                        |
| ------------- | ---------------------------------------------------------------------------------------------------- |
| Heading       | Section title, for structuring a long report                                                         |
| Text          | Free-written commentary                                                                              |
| Device note   | A note tied to a specific device                                                                     |
| File / image  | An uploaded image or file, embedded inline                                                           |
| Live KPI plot | A chart configuration (which series, which experiments) that re-renders live — not a static snapshot |

<Note>
  A **live KPI plot** segment stores the chart's *configuration* (which experiments, which series), not a frozen image. If the underlying data changes — a pipeline is re-run, a new experiment is added — the report reflects it automatically next time it's viewed.
</Note>

## Filtering and exporting

Reports can be filtered to a subset of the experiments they reference, and exported for sharing outside the app.