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

# Viewing and managing ownership

Once your catalog has owners assigned, Cortex gives you several ways to slice that data: by individual, by team, or across a team hierarchy. This page covers how to find the entities you own, filter by team, and remove ownership that's no longer accurate.

## Viewing an entity's owners

When viewing an entity, the owners appear in the metadata bar on the right side of the page:

![The Owners section in an entity's metadata sidebar.](https://mintcdn.com/cortex-290c0c42/IxDb4qc9F4yJyBqi/images/owners-entity-details.png?fit=max\&auto=format\&n=IxDb4qc9F4yJyBqi\&q=85\&s=9f75a78836e48f641239ccb2ce3a96fb)

If the entity is owned by a team, click the team name to open the team's entity page, which lists its members and owned entities. If owned by an individual, Cortex displays the user's email. If an owner was inherited from a parent entity, click the inheritance chain icon next to it to see where it came from. For information on assigning owners, refer to [Assigning owners to entities](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/assigning-owners-to-entities.md).

## Finding entities without owners

There are a few ways to find entities in your catalog that don't have owners yet:

* Use the [Ownership tool](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/assigning-owners-to-entities.md#assigning-ownership-via-cortex-recommendations) to see unowned entities and Cortex's automated recommendations for owners.
* In your catalogs, click **Filter** and select **Unowned entities**.
* View the [Executive report](https://docs.cortex.io/improve/reports/executive-report.md), which lists unowned entities.
* Run an [Ownership Verification Scorecard](https://docs.cortex.io/standardize/scorecards/create.md#option-1-use-a-template), which adds tasks to your homepage for any entities still missing owners.

## Viewing entities you own

1. From the main sidebar, expand **Catalog**, then select **All entities**.
2. Select the **Mine** tab. A list of entities you own is displayed.

   ![The Entities page showing all entities owned by the user.](https://mintcdn.com/cortex-290c0c42/uWo5OVZ0DdR5tZ8Q/images/entities-owner.png?fit=max\&auto=format\&n=uWo5OVZ0DdR5tZ8Q\&q=85\&s=c1b9b555b995f985186173162af3ee8e)

### Viewing child team ownership

1. From the main sidebar, expand **Catalog**, then select **All entities**.
2. Select the **Mine** tab.
3. At the top of the list, click **Display**.
4. Toggle on **Include child teams**.

   ![The 'Include child teams' option, toggle on.](https://mintcdn.com/cortex-290c0c42/HbTtnyKVq-sSUnnp/images/include-child-teams.png?fit=max\&auto=format\&n=HbTtnyKVq-sSUnnp\&q=85\&s=f661a9692dd7c63446ef2177b844547d)
5. Click **Done**.

## Viewing a team's owned entities

1. From the main sidebar, expand **Catalog**, then select **All entities**.
2. Select the **All** tab.
3. At the top of the list, click **Filter**.
4. In the **Filter** window, click **Teams**.

   ![The 'Teams' option in the Filter window.](https://mintcdn.com/cortex-290c0c42/cWUAMd9sewD6GxO9/images/view-team-entities.png?fit=max\&auto=format\&n=cWUAMd9sewD6GxO9\&q=85\&s=1187aa577877ef10b402cbca3b839230)
5. Select a team or teams from the drop-down menu.
6. Click **Apply**.

### Viewing entities owned by all teams within a hierarchy

Teams can exist [within hierarchies](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/adding-entities/teams/viewing-teams.md#understanding-hierarchies). To view a list of entities owned by the parent team and all children teams in the hierarchy:

1. Navigate to the parent team's page.
2. Select the **Entities** tab.

   ![The 'Entities' tab on a team's page.](https://mintcdn.com/cortex-290c0c42/cWUAMd9sewD6GxO9/images/team-page-entities-tab.png?fit=max\&auto=format\&n=cWUAMd9sewD6GxO9\&q=85\&s=7e417152a31739617ba7a313e58c6051)
3. At the top of the list, click **Display**.
4. Toggle on **Inherited Children**.

   ![The 'Inherited children' option toggled on.](https://mintcdn.com/cortex-290c0c42/cWUAMd9sewD6GxO9/images/teams-inherited-children.png?fit=max\&auto=format\&n=cWUAMd9sewD6GxO9\&q=85\&s=c38136412c7507c8f26c6b631bbd6a3a)
5. Click **Done**.

The list displays all entities owned by the parent and its children teams. Note that this setting does not persist when you navigate away from the page.

## Removing ownership

To remove an owner, use the same method you used to add them.

### Removing ownership via the Cortex UI

1. Navigate to the [entity's details page](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/details.md).
2. In the upper right corner, click **Configure entity**.
3. In the left sidebar, select **Owners**.
4. Locate the team or user you want to remove, then click the **trash icon**. The **Confirm team owner deletion** modal opens.
5. Click **Delete**.

### Removing ownership via YAML

* Update the `x-cortex-owners` block in your YAML to reference only the correct teams or individuals. Ensure that all referenced teams actually exist in Cortex.
* If using [GitOps](https://docs.cortex.io/configure/gitops), make sure the YAML is updated and merged to your main branch, then allow Cortex to re-sync. This updates the ownership in the UI to match the YAML.

### Removing ownership via API

Use the [Create or update entity API](https://docs.cortex.io/api/rest/catalog-entities#post-api-v1-open-api) to completely replace the entity YAML, or the [Create or patch entity API](https://docs.cortex.io/api/rest/catalog-entities#patch-api-v1-open-api) to remove one or more owner and not change the rest of the entity YAML.

### Removing inherited ownership

* Check if the entity is a child of a domain, or of an entity linked by a relationship type, with [ownership inheritance](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-inheritance.md) enabled. If so, the parent’s owners may be appended to the entity.
* To remove inherited owners, edit the domain or parent’s owner inheritance setting (for example, change it from `APPEND` to `NONE`).


## Related topics

- [Ownership best practices](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-best-practices.md)
- [Configuring identity mappings](https://docs.cortex.io/configure/settings/managing-users/identity-mapping.md)
- [Ownership inheritance](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/ownership-inheritance.md)