> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Upgrade single tenant to Zuora Multi-Org

> Learn how to migrate a single tenant to Zuora Multi-Org using the Multiple Organization APIs.

Learn how to migrate a single tenant to Zuora Multi-Org using the Multiple Organization APIs.

Contact [Zuora Global Support](https://support.zuora.com/hc/en-us) to initiate your Multi-Org migration. The support team will connect you with the Zuora Multi-Org team to guide you through the process.

Create the organizational hierarchy using the Multiple Organization APIs.

Label the key objects:

1. Customer Accounts
2. Products in the Product Catalog
3. Users

Repeat the labeling process until all applicable objects are assigned to the correct organizations.

Review audit log to validate labeling changes to the key objects.

Prepare users for the transition by completing internal change management activities and communicating the new organizational visibility model.

Validate the configuration and activate Zuora Multi-Org.

In addition to the three key object types listed above, more than 100 dependent object types are automatically labeled based on the labels assigned to those key objects. For more information about data labeling, see the the [Multiple Organizations API reference.](https://developer.zuora.com/v1-api-reference/api/tag/Data-Labeling/)