# Reports

Turn dashboard context into persisted report documents for experiment recaps, ablation notes, checkpoint decisions, launch notes, sweep summaries, and teammate handoffs.

![Reports editor with block-based content and live metric panels](/docs/assets/images/product/dashboard-reports-editor.png)

## Create a report

Open the Reports tab and use either create button:

- **Start from template** creates a report from the "Experiment readout" template, a prefilled starter document for a standard experiment writeup.
- **New report** creates a blank report.

Both open the editor at `/dashboard/reports/{report_id}`. Creating and editing reports requires workspace write access; viewers can read reports but not change them.

The Reports list shows every report visible to the active workspace.

## Build with blocks

Reports are block-based documents. Current block types include:

- Headings, paragraphs, markdown, code, horizontal rules, and callouts.
- Images.
- Panel grids with live metric charts, scalar panels, run comparers, markdown, code, and image panels.

> **Note:** Legacy LLM summary blocks remain readable in existing reports so older writeups keep rendering, but they are read-only. New reports should use narrative blocks and panel grids.

## Edit with auto-save

The editor auto-saves title, description, visibility, and block changes through the reports API. The toolbar shows save state, undo/redo controls, share, and Markdown export.

## Choose visibility

Use the visibility selector to choose the audience:

| Visibility | Who can see it |
| --- | --- |
| Private | Only you |
| Organization | Your team — everyone in the workspace |
| Public | Anyone with the link |

## Share and export

The Share action creates or rotates a share token and exposes a public `/r/...` link. Export opens a Markdown response for review, archives, or follow-up analysis outside InstantML.

## Choose between reports and saved views

Saved workspace views preserve dashboard layout and filters from Runs. Reports are separate persisted documents. Use saved views for repeatable dashboard state, and use reports when the result needs narrative context, charts, evidence, and a shareable readout.

## Next steps

- [Runs workspace](/docs/dashboard/runs-workspace.md)
- [Metrics and charts](/docs/dashboard/metrics-charts.md)
- [Compare runs](/docs/dashboard/compare-runs.md)
- [Reports API](/docs/api/reports.md)

## Agent navigation

- [Docs index](/llms.txt)
- [Full docs bundle](/llms-full.txt)

### Get Started

- [Overview](/docs/index.md)
- [Quickstart](/docs/quickstart.md)
- [Core Concepts](/docs/concepts/core-concepts.md)
- [Pricing](/docs/pricing.md)
- [Benchmarks](/docs/benchmarks.md)
- [Examples](/docs/guides/examples.md)
- [Troubleshooting](/docs/troubleshooting.md)

### SDK

- [Installation Auth](/docs/sdk/installation-auth.md)
- [Logging](/docs/sdk/logging.md)
- [Tracing](/docs/sdk/tracing.md)
- [Metrics Steps](/docs/sdk/metrics-steps.md)
- [Config Tags Notes](/docs/sdk/config-tags-notes.md)
- [Artifacts Checkpoints](/docs/sdk/artifacts-checkpoints.md)
- [Rich Objects](/docs/sdk/rich-objects.md)
- [Distributed Training](/docs/sdk/distributed-training.md)
- [Console System Integrations](/docs/sdk/console-system-integrations.md)
- [Reliability](/docs/sdk/reliability.md)
- [Cli Login](/docs/sdk/cli-login.md)
- [Querying Data](/docs/sdk/querying-data.md)
- [Agent Mcp](/docs/sdk/agent-mcp.md)
- [Examples Patterns](/docs/sdk/examples-patterns.md)

### Integrations

- [Overview](/docs/integrations/overview.md)
- [Pytorch Lightning](/docs/integrations/pytorch-lightning.md)
- [Huggingface Transformers](/docs/integrations/huggingface-transformers.md)
- [Keras](/docs/integrations/keras.md)
- [Wandb](/docs/integrations/wandb.md)

### Dashboard

- [Tour](/docs/dashboard/tour.md)
- [Organizations Workspaces](/docs/dashboard/organizations-workspaces.md)
- [Runs Workspace](/docs/dashboard/runs-workspace.md)
- [Metrics Charts](/docs/dashboard/metrics-charts.md)
- [Run Detail](/docs/dashboard/run-detail.md)
- [Traces](/docs/dashboard/traces.md)
- [Compare Runs](/docs/dashboard/compare-runs.md)
- [Research Dashboards](/docs/dashboard/research-dashboards.md)
- [Artifacts Files](/docs/dashboard/artifacts-files.md)
- [Run Health](/docs/dashboard/alerts.md)
- [Datasets](/docs/dashboard/datasets.md)
- [Checkpoints](/docs/dashboard/checkpoints.md)
- [Reports](/docs/dashboard/reports.md) (current page)
- [Settings Api Keys](/docs/dashboard/settings-api-keys.md)
- [Api Tab](/docs/dashboard/api-tab.md)
- [Onboarding Team Billing](/docs/dashboard/onboarding-team-billing.md)

### Data

- [Imports](/docs/guides/imports.md)
- [W&B alternative](/docs/guides/wandb-alternative.md)
- [InstantML vs MLflow](/docs/guides/instantml-vs-mlflow.md)
- [W&B import guide](/docs/guides/wandb-import-guide.md)
- [W&B and Neptune imports](/docs/guides/wandb-neptune-imports.md)
- [Export Usage Limits](/docs/guides/export-usage-limits.md)
- [Pricing Limits Billing](/docs/guides/pricing-limits-billing.md)
- [Auth Billing Storage](/docs/guides/auth-billing-storage.md)
- [Customer Owned Clickhouse](/docs/guides/customer-owned-clickhouse.md)
- [Observability](/docs/guides/observability.md)

### API

**Practical API guides**

- [Authentication](/docs/api/authentication.md)
- [Errors And Limits](/docs/api/errors-and-limits.md)
- [Health Observability](/docs/api/health-observability.md)
- [Projects Runs](/docs/api/projects-runs.md)
- [Metrics Series](/docs/api/metrics-series.md)
- [Attributes Objects](/docs/api/attributes-objects.md)
- [Artifacts](/docs/api/artifacts.md)
- [Reports](/docs/api/reports.md)
- [Iframe Embeds](/docs/api/iframe-embeds.md)
- [Import Export Usage](/docs/api/import-export-usage.md)
- [Dashboard Control State](/docs/api/dashboard-control-state.md)
**Architecture**

- [System Overview](/docs/architecture/system-overview.md)
- [Service Planes](/docs/architecture/service-planes.md)
- [Storage Model](/docs/architecture/storage-model.md)
- [Google Clickhouse](/docs/architecture/google-clickhouse.md)
- [Auth Tenancy](/docs/architecture/auth-tenancy.md)
- [Schema Reference](/docs/architecture/schema-reference.md)

### API Reference

- [API Reference](/docs/api-reference.md)