Skip to main content

Overview of Multi-entity


Overview of Multi-entity

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

Zuora Multi-entity provides the capability to create and manage multiple entities within a single Zuora tenant. An entity represents a legal entity or an independently operated business unit. Each entity can manage its own business objects (such as subscription, invoice, and payment), settings, transactions, and features (such as Orders and Invoice Settlement). Zuora Multi-entity allows you to:

  • Log in as a corporate user to run reports and view data across entities
  • Model your enterprise organization in a multi-entity hierarchy
  • Keep the business operations isolated among entities
  • Limit data access within different entities
  • Grant user access across entities
  • Define business objects centrally in a single entity, and share with other entities
  • Share certain settings and business objects across entities

Multi-entity hierarchy

Zuora Multi-entity hierarchy shows the structure of your entities. You can manage your multi-entity hierarchy to structure your global enterprise organization within a single tenant. New entities can be added or edited as company structure changes.

See Introduction to Entity and Entity Hierarchy and Management of Entity and Entity Hierarchy for more information.

Business objects sharing across entities

Zuora offers sharing and central management options to make management across entities easier. You can define accounting periods centrally in a single entity and share with other entities. You can also share products within a multi-entity hierarchy, which allows entities to cross-sell products from other entities.

See Business Objects Sharing Across Entities for more information.

User access across entities

Each entity is completely isolated from other entities. A user by default can only access the entity in which the user is created. To access the other entities, the user must be granted permission to access them. Only the entity administrators have permission to grant or deny user access.

See User Access within Multi-entity Hierarchy for more information.

Entity switcher

The entity switcher lists all the provisioned entities in the multi-entity hierarchy. After you logged in from the Zuora UI, you can switch to the entities that you have permission to access from the entity switcher.

The entity switcher is in the upper right of the page and next to your login user name. When you click the current entity display name, the multi-entity hierarchy is displayed. You can click an entity display name from the entity switcher to access the entity. Also, you can search for an entity display name in the entity search field. The entities that you do not have permission to access are grayed out.


API user authentication

When making API calls, you can specify which entity you want to make the call to:

Multi-entity use case

The most common use case where multi-entity is required is for companies who sell products globally, but the pricing, tax, and accounting code are different per geographical region. In this use case, the Acme corporation sells products in the Americas, Europe, and Asia. The following figure gives you the multi-entity hierarchy of the Acme corporation:


The Acme Corporation entity is the global entity of the entity hierarchy. As an administrator of the Acme Corporation entity, you can create and manage entities to organize your business regions. The following sub-entities are defined based on each region under the Acme Corporation entity:

  • Americas
    • US
    • Canada
  • Europe
    • UK
    • France
  • Asia
    • China
    • Japan

In a multi-entity environment, the Acme corporation can:

  • Manage business objects, settings, and transactions of all sub-entities with a single login as an administrator of the Acme Corporation entity. For example, after logging in as an administrator, you can switch to the US entity and then configure the settings of the US entity.
  • Each entity can have its own pricing, currency, tax, settings, and so on. For example, the US entity can use USD as its home currency while the Canada entity can use CAD as its home currency.
  • Define accounting periods in the Acme Corporation entity and share with other sub-entities. 
  • Perform the accounting close process separately for each entity. 
  • Operations such as bill runs, payment runs, and journal runs are kept separate for each entity. For example, if you created a bill run in the US entity, the other entities are not affected.
  • Each entity can create reports separately.
  • Each entity can have their own time zone settings.
  • Each entity can have their own custom field definitions. However, if needed, custom field definitions can be shared between the global entity and its sub-entities.
  • Each entity user can only see objects that they are allowed to see. For example, product rate plans created in the China entity are not viewable by Japan entity users unless they are given permission.
  • A sub-entity user can be granted access to other entities and assign different roles and permissions in other entities. For example, an administrator of the UK entity can be assigned as a standard user of the Europe entity.
  • The Acme Corporation entity can share products with its sub-entities. After receiving the shared products, the sub-entities can customize certain information of the shared products based on their own requirements.
  • The Acme Corporation entity administrators can configure the security policies. Sub-entities will inherit the security policies from it.