Migrate from legacy Model Registry

W&B is migrating from the legacy Model Registry to the enhanced W&B Registry. This transition is designed to be seamless and fully managed by W&B. The migration process will preserve your workflows while unlocking powerful new features. For any questions or support, contact support@wandb.com.

Reasons for the migration

W&B Registry offers major improvements over the legacy Model Registry:

  • Unified, organization-level experience: Share and manage curated artifacts across your organization, regardless of teams.
  • Improved governance: Use access control, restricted registries, and visibility settings to manage user access.
  • Enhanced functionality: New features such as custom registries, better search, audit trails, and automation support help modernize your ML infrastructure.

The following table summarizes the key differences between the legacy Model Registry and the new W&B Registry:

Feature Legacy W&B Model Registry W&B Registry
Artifact Visibility Team-level only - access restricted to team members Org-level visibility with fine-grained permission controls
Custom Registries Not supported Fully supported — create registries for any artifact type
Access Control Not available Role-based access (Admin, Member, Viewer) at the registry level
Terminology “Registered models”: pointers to model versions “Collections”: pointers to any artifact versions
Registry Scope Only supports model versioning Supports models, datasets, custom artifacts, and more
Automations Registry-level automations Registry- and collection-level automations supported and copied during migration
Search & Discoverability Limited search and discoverability Central search within W&B Registry across all registries in the organization
API Compatibility Uses wandb.init.link_model() and MR-specific patterns Modern SDK APIs (link_artifact(), use_artifact()) with auto-redirection
Migration End-of-life Automatically migrated and enhanced — data is copied, not deleted

Preparing for the migration

  • No action required: The migration is fully automated and managed by W&B. You do not need to run scripts, update configurations, or move data manually.
  • Stay informed: You will receive communications (banners in the W&B App UI) 2 weeks prior to your scheduled migration.
  • Review permissions: After the migration, admins should check registry access to ensure alignment with your team’s needs.
  • Use new paths in future work: Old code continues to work, W&B recommends using the new W&B Registry paths for new projects.

Migration process

Temporary write operation pause

During migration, write operations for your team’s Model Registry will be paused to ensure data consistency for up to one hour. Write operations to the newly created migrated W&B Registry will also be paused during the migration.

Data migration

W&B will migrate the following data from the legacy Model Registry to the new W&B Registry:

  • Collections
  • Linked artifact versions
  • Version history
  • Aliases, tags, and descriptions
  • Automations (both collection and registry-level)
  • Permissions, including service account roles and protected aliases

Within the W&B App UI, the legacy Model Registry will be replaced with the new W&B Registry. Migrated registries will have the name of your team followed by mr-migrated:

<team-name>-mr-migrated

These registries default to Restricted visibility, preserving your existing privacy boundaries. Only the original members of the <team-name> will have access to their respective registries.

After the migration

After the migration completes:

Code will continue to work

Existing API calls in your code that refer to the legacy Model Registry will automatically redirect to the new W&B Registry. The following API calls will continue to work without any changes:

  • wandb.Api().artifact()
  • wandb.run.use_artifact()
  • wandb.run.link_artifact()
  • wandb.Artifact().link()

Legacy paths will redirect to new W&B Registry paths

W&B will automatically redirect legacy Model Registry paths to the new W&B Registry format. This means you can continue using your existing code without needing to refactor paths immediately.

In the legacy Model Registry, paths consisted of a team name, a "model-registry" string, collection name, and version:

f"{team-name}/model-registry/{collection-name}:{version}"

W&B will automatically redirect these paths to the new W&B Registry format, which includes the organization name, a "wandb-registry" string, the team name, collection name, and version:

# Redirects to new path
f"{org-name}/wandb-registry-{team-name}/{collection-name}:{version}"

Frequently asked questions

How will I know when my org is being migrated?

You will receive advance notice with an in-app banner or direct communication from W&B.

Will there be downtime?

Write operations to the legacy Model Registry and the new W&B Registry will be paused for a approximately one hour during the migration. All other W&B services will remain available.

Will this break my code?

No. All legacy Model Registry paths and Python SDK calls will automatically redirect to the new Registry.

Will my data be deleted?

No. Your data will be copied to the new W&B Registry. The legacy Model Registry becomes read-only and later hidden. No data is removed or lost.

What if I’m using an older SDK?

Redirects will still work, but you will not see warnings about them. For the best experience, upgrade to the latest version of the W&B SDK.

Can I rename/modify my migrated registry?

Yes, renaming and other operations such as adding or removing members from a migrated registry are allowed. These registries are simply custom registries underneath, and the redirection will continue working even after migration.

Questions?

For support or to discuss your migration, contact support@wandb.com. W&B is committed to helping you transition smoothly to the new W&B Registry.