> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-sdk-testing-latest.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Create a W&B Report with the W&B App or programmatically.

# Create a report

<Note>
  W\&B Report and Workspace API is in Public Preview.
</Note>

W\&B Reports let you share findings, results, and visualizations from your runs with collaborators. Create a report from a project workspace, from the **Reports** tab, or programmatically with the Report and Workspace API. Select a tab to get started.

For a programmatic example, see the [Report API Quickstart Google Colab](https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/Report_API_Quickstart.ipynb).

<Tabs>
  <Tab title="W&B App">
    1. Navigate to your project workspace in the W\&B App.

    2. In the upper-right corner of your workspace, click **Create report**.

           <Frame>
             <img src="https://mintcdn.com/wb-21fd5541-sdk-testing-latest/9bGjVEZnWlpBI-9p/images/reports/create_a_report_button.png?fit=max&auto=format&n=9bGjVEZnWlpBI-9p&q=85&s=4d8e5ca6fe003e8536c688986a28210f" alt="Create report button" width="2510" height="462" data-path="images/reports/create_a_report_button.png" />
           </Frame>

    3. A modal appears. Select the charts you want to start with. You can add or remove charts later from the report interface.

           <Frame>
             <img src="https://mintcdn.com/wb-21fd5541-sdk-testing-latest/H06KgVKW2CsyczDM/images/reports/create_a_report_modal.png?fit=max&auto=format&n=H06KgVKW2CsyczDM&q=85&s=3535b9a4e2136c51f4b86f43219d76bc" alt="Create report modal with chart selection options" width="920" height="840" data-path="images/reports/create_a_report_modal.png" />
           </Frame>

    4. To prevent W\&B from adding more runs to your report, select **Filter run sets**. W\&B saves a draft report automatically. Access it in the **Reports** tab.
  </Tab>

  <Tab title="Report tab">
    1. Navigate to your project workspace in the W\&B App.
    2. Select the **Reports** tab in your project.
    3. Click **Create report**.

           <Frame>
             <img src="https://mintcdn.com/wb-21fd5541-sdk-testing-latest/H06KgVKW2CsyczDM/images/reports/create_report_button.png?fit=max&auto=format&n=H06KgVKW2CsyczDM&q=85&s=ea65b006b27998ef35bbfa59db4383e9" alt="Create report button" width="2542" height="1614" data-path="images/reports/create_report_button.png" />
           </Frame>
  </Tab>

  <Tab title="Report and Workspace API">
    Create a report programmatically:

    1. Install the W\&B SDK (`wandb`) and the Report and Workspace API (`wandb-workspaces`):
       ```bash theme={null}
       pip install wandb wandb-workspaces
       ```

    2. Import the W\&B Python SDK and the Report and Workspace API:
       ```python theme={null}
       import wandb
       import wandb_workspaces.reports.v2 as wr
       ```

    3. Create a report instance with `wandb_workspaces.reports.v2.Report` or with the Report Class Public API ([`wandb.apis.reports`](/models/ref/python/public-api/api#reports)). Specify the project to associate with the report:
       ```python theme={null}
       report = wr.Report(project="report_standard")
       ```

    4. Save the report. W\&B doesn't upload reports until you call the `.save()` method:
       ```python theme={null}
       report.save()
       ```

    For more information, see [Edit a report](/models/reports/edit-a-report).
  </Tab>
</Tabs>
