Create a registry ↗

Original Documentation

Documentation Index#
Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt Use this file to discover all available pages before exploring further.

A registry offers flexibility and control over the artifact types that you can use, allows you to restrict the registry’s visibility, and more.

Create a registry#

Create a registry either programmatically using the W&B Registry UI or the W&B Python SDK.

Navigate to the W&B Registry at https://wandb.ai/registry/.
Click on the Create registry button.
Provide a name for the registry in the Name field.
Optionally provide a description about the registry.
Select who can view the registry from the Registry visibility dropdown. See Registry visibility types for more information on 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 on the Create registry button.

Use the wandb.Api().create_registry() method to create a registry programmatically. Provide a name and visibility for the registry for the name and visibility parameters, respectively.

Copy and paste the code block below. Replace the values enclosed in <> with your own:

    import wandb

    registry = wandb.Api().create_registry(
        name="<registry_name>",
        visibility="< 'restricted' | 'organization' >",
    )
    ```

See the  [`wandb.Api().create_registry()`](/models/ref/python/#method-apicreate_registry) method reference for a full list of parameters that you can provide when you create a registry.
  <span class="tab-end"></span>
<span class="tab-group-end"></span>

<span class="callout-start" data-callout-type="note"></span>
  An artifact type cannot be removed from a registry once it is saved in the registry's settings.
<span class="callout-end"></span>

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 that are manually added to the registry.


  <img src="https://mintcdn.com/wb-21fd5541/mmuC1X8m1VKb0ElQ/images/registry/create_registry.gif?s=ed1bfb32e7b17e30bb1e98ee3750d4a1" alt="Creating a new registry" data-og-width="3442" width="3442" data-og-height="1974" height="1974" data-path="images/registry/create_registry.gif" data-optimize="true" data-opv="3" />


## Visibility types

The *visibility* of a registry determines who can access that registry. Restricting the visibility of a registry helps ensure that only specified members can access that registry.

There are two type registry visibility options for a registry:

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

A team admin or registry admin can set the visibility of a registry.

The user who creates a registry with Restricted visibility is added to the registry automatically 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 the creation of a registry.

To restrict the visibility of an existing registry:

1. Navigate to the W\&B Registry at [https://wandb.ai/registry/](https://wandb.ai/registry/).
2. Select a registry.
3. Click on the gear icon on the upper right hand corner.
4. From the **Registry visibility** dropdown, select the desired registry visibility.
5. If you select **Restricted visibility**:
   1. Add members of your organization that you want to have access to this registry. Scroll to the **Registry members and roles** section and click on the **Add member** button.
   2. Within the **Member** field, add the email or username of the member you want to add.
   3. Click **Add new member**.


  <img src="https://mintcdn.com/wb-21fd5541/mmuC1X8m1VKb0ElQ/images/registry/change_registry_visibility.gif?s=273ab9752a47df04f6bd75ae36eabfab" alt="Changing registry visibility settings from private to public or team-restricted access" data-og-width="3616" width="3616" data-og-height="2140" height="2140" data-path="images/registry/change_registry_visibility.gif" data-optimize="true" data-opv="3" />


See [Create a registry](./create_registry#create-a-custom-registry) for more information on how assign the visibility of a registry when a team admin creates it.

Link last verified June 7, 2026. View original ↗

Source: Weights & Biases Docs

Link last verified: 2026-03-04