View experiment results

A playground for exploring run data with interactive visualizations

A W&B workspace is where you customize charts and explore model results. Use a workspace to visualize and compare runs across your project, organize panels for analysis, and share findings with your team. A W&B workspace consists of Tables and Panel sections:

• Tables: All runs logged to your project are listed in the project’s table. Turn on and off runs, change colors, and expand the table to see notes, config, and summary metrics for each run.
• Panel sections: A section that contains one or more panels. Create new panels, organize them, and export to reports to save snapshots of your workspace.

Workspace types

There are two main workspace categories: Personal workspaces and Saved views.

• Personal workspaces: A customizable workspace for in-depth analysis of models and data visualizations. Only the owner of the workspace can edit and save changes. Teammates can view a personal workspace but teammates can’t make changes to someone else’s personal workspace.
• Saved views: Saved views are collaborative snapshots of a workspace. Anyone on your team can view, edit, and save changes to saved workspace views. Use saved workspace views for reviewing and discussing experiments, runs, and more.

The following image shows multiple personal workspaces created by Cécile-parker’s teammates. This project has no saved views:

Saved workspace views

Create saved views to organize your preferred setup of charts and data, and to collaborate with your team.

Create a new saved workspace view

1. Navigate to a personal workspace or a saved view.
2. Make edits to the workspace.
3. Click the action () menu at the top right corner of your workspace. Click Save as a new view.

New saved views appear in the workspace navigation menu.

Update a saved workspace view

Saved changes overwrite the previous state of the saved view. W&B doesn’t retain unsaved changes. To update a saved workspace view in W&B:

1. Navigate to a saved view.
2. Make the desired changes to your charts and data within the workspace.
3. Click the Save button to confirm your changes.

A confirmation dialog appears when you save your updates to a workspace view. If you prefer not to see this prompt in the future, select the option Do not show this modal next time before confirming your save.

Delete a saved workspace view

Remove saved views that are no longer needed.

1. Navigate to the saved view you want to remove.
2. Select the menu () button at the top right of the view.
3. Choose Delete view.
4. Confirm the deletion to remove the view from your workspace menu.

Share a workspace view

Share your customized workspace with your team by sharing the workspace URL directly. All users with access to the workspace project can see the saved views of that workspace.

Workspace templates

This feature requires an Enterprise license.

Use workspace templates to create workspaces using the same settings as an existing workspace instead of the default settings for new workspaces. Templates let you standardize how new workspaces look and behave so you don’t have to reconfigure each one.

Default workspace settings

W&B uses the following default settings for workspaces:

Hide empty sections during search

By default, W&B doesn’t show empty sections in the workspace. You can change this setting to show empty sections in the workspace.

Sort panels alphabetically

By default, W&B doesn’t sort panels by plot title alphabetically. You can change this setting to sort panels alphabetically by their plot title.

Section organization

By default, W&B organizes panels into sections based on the first prefix of the metric name. For example, if your workspace includes the metrics a/b/c/d and a/e/f, W&B organizes these metrics into a section called a. If your workspace includes the metrics a/b/c/d and e/f/g, W&B organizes these metrics into sections called a and e.

You can change the default section organization to group by the last prefix. For example, if your workspace includes the metrics a/b/c/d and a/e/f, W&B organizes these metrics into sections called d and f. If your workspace includes the metrics a/b/c/d and e/f/g, W&B organizes these metrics into sections called d and g.

Line plot settings

By default, new workspaces use these default settings for line plots:

X axis	Default
Value	Step
Log scale	false

Y axis	Default
Log scale	false

Smoothing	Default
Type	Time weight EMA
Weight	0
Show original after smoothing	Off

Max number of runs	Default
Max runs	10

Data	Default
Point aggregation	Full fidelity

Grouping	Default
Use grouping in charts	On
Group aggregation	Mean

Display preferences	Default
Color run names	On
Display full run name	Off
Show X range in tooltip	Off
Tooltip runs	Default
Sync zoom across charts	Off
Show highlighted run only	Off

Configure your workspace template

1. Open any workspace or create a new one.
2. Click the Settings button at the top right corner of the workspace.
3. Select Workspace layout from the panel.
4. Configure the workspace’s settings according to your preferences.

Save your workspace template

After you configure a workspace’s settings, save them as your personal template so future workspaces inherit the same configuration.

1. At the top of the workspace, click the action () menu near the Undo and Redo arrow icons.
2. Click Save personal workspace template.
3. Review the settings for the template, then click Save.

New workspaces use these settings instead of the defaults.

View your workspace template

To view your workspace template’s current configuration:

1. From any page, select your user icon on the top right corner. From the dropdown, choose User Settings.
2. Navigate to the Personal workspace template section. If you’re using a workspace template, its configuration displays. Otherwise, the section includes no details.

Update your workspace template

To update your workspace template:

1. Open any workspace.
2. Modify the workspace’s settings. For example, set the number of runs to include to 11.
3. To save the changes to the template, click the action () menu near the Undo and Redo arrow icons, then click Update personal workspace template.
4. Verify the settings, then click Update. W&B updates the template and reapplies it to all workspaces that use it.

Delete your workspace template

To delete your workspace template and go back to the default settings:

1. From any page, select your user icon on the top right corner. From the dropdown, choose User Settings.
2. Navigate to the Personal workspace template section. Your workspace template’s configuration displays.
3. Click the trash icon next to Settings.

For Dedicated Cloud and Self-Managed, deleting your workspace template is supported on v0.70 and later. On earlier Server versions, update your workspace template to use the default settings instead.

Programmatically create workspaces

Create and customize workspaces from Python code when you want to automate workspace setup, version-control workspace definitions, or replicate the same layout across multiple projects.

For an end-to-end example, see Programmatic Workspaces notebook.

wandb-workspaces is a Python library for programmatically working with W&B workspaces and reports.

You can define the workspace’s properties, such as:

• Set panel layouts, colors, and section orders.
• Configure workspace settings like default x-axis, section order, and collapse states.
• Add and customize panels within sections to organize workspace views.
• Load and modify existing workspaces using a URL.
• Save changes to existing workspaces or save as new views.
• Filter, group, and sort runs programmatically using expressions.
• Customize run appearance with settings like colors and visibility.
• Copy views from one workspace to another for integration and reuse.

Install the Workspace API

In addition to wandb, ensure that you install wandb-workspaces:

pip install wandb wandb-workspaces

Define and save a workspace view programmatically

import wandb_workspaces.reports.v2 as ws

workspace = ws.Workspace(entity="[ENTITY-NAME]", project="[PROJECT-NAME]", views=[...])
workspace.save()

Edit an existing view

existing_workspace = ws.Workspace.from_url("[WORKSPACE-URL]")
existing_workspace.views[0] = ws.View(name="[VIEW-NAME]", sections=[...])
existing_workspace.save()

Copy a workspace saved view to another workspace

old_workspace = ws.Workspace.from_url("[OLD-WORKSPACE-URL]")
old_workspace_view = old_workspace.views[0]
new_workspace = ws.Workspace(entity="[NEW-ENTITY-NAME]", project="[NEW-PROJECT-NAME]", views=[old_workspace_view])

new_workspace.save()

See wandb-workspace examples for workspace API examples.