Create a report

Create a W&B Report with the App UI or programmatically with the Weights & Biases SDK.

  2 minute read  

Create a report interactively with the W&B App UI or programmatically with the W&B Python SDK.

  1. Navigate to your project workspace in the W&B App.

  2. Click Create report in the upper right corner of your workspace.

  3. A modal will appear. Select the charts you would like to start with. You can add or delete charts later from the report interface.

  4. Select the Filter run sets option to prevent new runs from being added to your report. You can toggle this option on or off. Once you click Create report, a draft report will be available in the report tab to continue working on.

  1. Navigate to your project workspace in the W&B App.

  2. Select to the Reports tab (clipboard image) in your project.

  3. Select the Create Report button on the report page.

Create a report programmatically with the wandb library.

  1. Install W&B SDK and Workspaces API:

    pip install wandb wandb-workspaces
    Bash

  2. Next, import workspaces

    import wandb
import wandb_workspaces.reports.v2 as wr
    Python

  3. Create a report with wandb_workspaces.reports.v2.Report. Create a report instance with the Report Class Public API (wandb.apis.reports). Specify a name for the project.

    report = wr.Report(project="report_standard")
    Python

  4. Save the report. Reports are not uploaded to the W&B server until you call the .save() method:

    report.save()
    Python

For information on how to edit a report interactively with the App UI or programmatically, see Edit a report.


Last modified May 7, 2025