---
title: Configure entity ownership
source: https://docs.newrelic.com/docs/service-architecture-intelligence/teams/team-ownership
---

Assigning entities to teams in New Relic is key to establishing clear ownership and enabling effective collaboration. You can define ownership through automated tag-based assignment or manual methods.

## Automate ownership with tags [#assign-ownership]

One of the simplest and most efficient ways to assign entity ownership is by applying labels (tags) directly in your agent configuration files.

### Tag entities in your agent configuration file [#tag-entities]

Start by adding a team label to your agent configuration to specify which team owns a given entity.
For example, in a Java agent, you can add:

```
<labels>team:Backend</labels>
```

This tag associates the entity with the "Backend" team.

### Automate entity assignment to teams [#entity-assignment]

To automate the assignment of tagged entities to their respective teams:

1.  Go to **All Capabilities > Teams > Automation**.
2.  Enable the **Entity ownership** feature.
    Once enabled, New Relic will automatically assign any entity with a matching team tag to the corresponding team.

### (Optional) Use Team aliases [#team-aliases]

If your organization uses different identifiers for the same team (e.g., "Backend" and "BE"), you can configure aliases to ensure consistency. To do so:

1.  Open the **Team Hub** page for the relevant team.
2.  Go to the **Settings** section.
3.  Add aliases that map alternative tag values to the same team.
    With aliases in place, entities tagged with either "team:Backend" or "team:BE" will both be assigned to the "Backend" team.

> #### 💡 TIP
>
> You can also use any other ingested tags that represent ownership. This provides added flexibility and ensures alignment with your organization's current tagging conventions.

### Manually assign ownership [#manual-ownership]

If you don't have tags set up to represent ownership, you can manually assign ownership in the following places.

#### In Team hub page [#ownership-via-hub]

To assign ownership from the Team Hub:

1.  Go to the Team's hub page and click **Entity management**.

2.  Select your entities you want to assign.

3.  Click **Save**.

#### In entity pages [#entity-pages]

You can also assign an owner directly from any entity's summary page header.

![Screenshot showing teams from entity page](https://docs.newrelic.com/images/teams_entity_summary_page.webp "Screenshot showing teams from entity page")

#### In Catalogs [#entity-headers]

Ownership can be assigned to unowned catalog entries that are not yet linked to a team.

[Manage Teams](https://docs.newrelic.com/docs/service-architecture-intelligence/teams/manage-teams)

Learn how to create and manage teams

[NerdGraph API](https://docs.newrelic.com/docs/apis/nerdgraph/examples/nerdgraph-teams-tutorial)

See how to complete the same teams tasks using GraphQL
