> For the complete documentation index, see [llms.txt](https://docs.cortex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cortex.io/ingesting-data-into-cortex/entities-overview/entities/ownership/viewing-and-managing-ownership.md).

# 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 entities you own

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

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FYVhzINOJ1eib24bcYIrg%2Fentities-owner.png?alt=media&amp;token=5a596f6d-5e66-47b2-8980-34feb900c4fb" alt="The Entities page showing all entities owned by the user." width="375"><figcaption></figcaption></figure></div>

### Viewing child team ownership

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

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FJY1H0Anw0h2VJJvi5COi%2Finclude-child-teams.png?alt=media&amp;token=1b25b9f6-9f06-474b-9217-6a0ea96415e5" alt="The &#x27;Include child teams&#x27; option, toggle on." width="375"><figcaption></figcaption></figure></div>
5. Click **Done**.

## Viewing a team's owned entities

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

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FzIq6I7Kq5g0RjZPRE8dP%2Fview-team-entities.png?alt=media&amp;token=bb501590-17c4-409b-bfa4-f9d02d5f3d3d" alt="The &#x27;Teams&#x27; option in the Filter window." width="375"><figcaption></figcaption></figure></div>
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](/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.<br>

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2F63gsw0BdExw4ulCmVs1W%2Fteam-page-entities-tab.png?alt=media&amp;token=2304b355-7fd0-4a27-bae6-df1aa4d51d60" alt="The &#x27;Entities&#x27; tab on a team&#x27;s page." width="375"><figcaption></figcaption></figure></div>
3. At the top of the list, click **Display**.
4. Toggle on **Inherited Children**.<br>

   <div align="left" data-with-frame="true"><figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FsmKySp0Y4VOJIAnS9yx7%2Fteams-inherited-children.png?alt=media&amp;token=d55fa680-79e3-447f-9e46-9c036a8bf4b7" alt="The &#x27;Inherited children&#x27; option toggled on." width="375"><figcaption></figcaption></figure></div>
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 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](/configure/gitops.md), 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](/api/readme/catalog-entities.md#post-api-v1-open-api) to completely replace the entity YAML, or the [Create or patch entity API](/api/readme/catalog-entities.md#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 group with [ownership inheritance](/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 (e.g. change from `Append` to `None`).
