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

# Management of entity and entity hierarchy

> Explains how to manage entities and multi-entity hierarchy.

Explains how to manage entities and multi-entity hierarchy.

When Multi-entity is enabled for a tenant, a multi-entity hierarchy is automatically created with only a provisioned global entity. You can manage the multi-entity hierarchy to add, provision, edit, or remove entities through the Zuora UI and REST API.

The following operations are supported to manage the entities and multi-entity hierarchy from the Zuora UI and REST API:

* [Add entities to a multi-entity hierarchy](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/add-an-entity-to-an-entity-hierarchy)
* [Provision entities](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/provision-an-entity)
* [Edit certain information of entities](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/edit-entity-information)
* [Remove unprovisioned entities](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/edit-entity-information)
* [View Multi-entity Hierarchy](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/remove-an-entity) (UI only)
* [Retrieve entities](https://developer.zuora.com/v1-api-reference/older-api/operation/GET_Entities/)(REST API only)
* [Retrieve an entity by entity Id](https://developer.zuora.com/v1-api-reference/older-api/operation/GET_EntityById/) (REST API only)
* [Manage Status of Entities](/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/managing-status-of-entities)

Zuora does not allow you to do the following operations:

* Create a new entity hierarchy
* Remove an existing multi-entity hierarchy
* Change the parent entity of an entity
* Restructure the multi-entity hierarchy
* Remove a provisioned entity

> Explains how to manage entities and multi-entity hierarchy.

## Docs

- [Add an entity to an entity hierarchy](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/add-an-entity-to-an-entity-hierarchy.md): Learn to add entities to a multi-entity hierarchy using Zuora UI or REST API.
- [Provision an entity in a entity hierarchy](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/provision-an-entity.md): Learn how to provision an entity in a multi-entity hierarchy within Zuora.
- [Edit the global entity information from Zuora UI](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/edit-entity-information.md): Learn to edit global and sub-entity information using the Zuora UI and REST API.
- [Edit the unprovisioned sub-entity information from Zuora UI](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/edit-the-unprovisioned-sub-entity-information-from-zuora-ui.md): Learn how to edit unprovisioned sub-entity information in Zuora UI.
- [Edit the provisioned sub-entity information from Zuora UI](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/edit-the-provisioned-sub-entity-information-from-zuora-ui.md): Learn to edit the name and display name of provisioned sub-entities in the Zuora UI.
- [Remove an entity from the entity hierarchy](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/remove-an-entity.md): Learn how to remove unprovisioned entities from the Multi-entity hierarchy in Zuora.
- [View entity hierarchy in Multi-entity](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/from-the-management-entity-hierarchy-page.md): Learn how to view the entity hierarchy using the entity switcher or management entity hierarchy page.
- [Managing status of entities](https://zuora.ferndocs.com/docs/platform/user-management/multi-entity/multi-entity-hierarchy-management/management-of-entity-and-entity-hierarchy/managing-status-of-entities.md): A subentity in a multi-entity hierarchy has a status that controls whether the subentity appears in the entity hierarchy and whether you can reuse its name.