Create a registry

This page shows organization and team admins how to create a W&B Registry and configure its visibility and accepted artifact types.

You can create a registry either interactively using the W&B Registry UI or programmatically using the W&B Python SDK.

W&B Registry UI
Python SDK

Navigate to the W&B Registry.
Click the Create registry button.
Provide a name for the registry in the Name field.
Optional: Provide a description of the registry.
Select who can view the registry from the Registry visibility dropdown. See Visibility types for more information about registry visibility options.
Select either All types or Specify types from the Accepted artifacts type dropdown.
If you select Specify types, add one or more artifact types that your registry accepts.
Click the Create registry button.

Use the wandb.Api().create_registry() method to create a registry programmatically. Provide a name and visibility using the name and visibility parameters.Copy and paste the code block below. Replace [REGISTRY-NAME] with a name for your registry, and replace [VISIBILITY] with either restricted or organization:

import wandb

registry = wandb.Api().create_registry(
    name="[REGISTRY-NAME]",
    visibility="[VISIBILITY]",
)

See the wandb.Api().create_registry() method reference for a full list of parameters that you can provide when you create a registry.

After you save an artifact type in the registry’s settings, you can’t remove it from the registry.

For example, the following image shows a registry called Fine_Tuned_Models that a user is about to create. The registry is Restricted to only members who are manually added to the registry.

Visibility types

The visibility of a registry determines who can access it. Restricting visibility ensures that only specified members have access. A registry has two visibility options:

Visibility	Description
Restricted	Only invited organization members can access the registry.
Organization	Everyone in the organization can access the registry.

A team admin or registry admin can set the visibility of a registry. W&B automatically adds the user who creates a registry with Restricted visibility to the registry as its registry admin.

Configure the visibility of a registry

A team admin or registry admin can assign the visibility of a registry during or after creating it. Use the following procedure to change the visibility of a registry you have already created. To restrict the visibility of an existing registry:

Navigate to the W&B Registry.
Select a registry.
Click the gear icon in the upper right corner.
From the Registry visibility dropdown, select a visibility option.
If you select Restricted visibility:
1. Add members of your organization who you want to have access to this registry. Scroll to the Registry members and roles section and click the Add member button.
2. In the Member field, add the email or username of the member you want to add.
3. Click Add new member.

For more information about assigning visibility when a team admin creates a registry, see Create a registry.

Guides

Integrations

Reference

Create a registry