# Ownership teams

{% hint style="info" %}
Team ownership features are only available on Growth and Isolation plans.
{% endhint %}

If you ever wondered, **"Who are the experts on this app in my system?",** you can find exactly that with Ownership teams on IcePanel.

Ownership teams are a great way to show groups of people as experts on an object, giving better accountability for keeping everything updated. On each assigned object, you can see the names, roles and emails of those in the assigned team(s) so you can speak to the right person quickly.  Object details can also be locked so they're only editable by team owners.

## Creating an ownership team

{% hint style="info" %}
Only organization Admins can create, edit and delete teams.
{% endhint %}

To create an ownership team from the landscape page:

1. Navigate to the `Teams` tab.
2. Click the `+ New team` button.
   * If you have already created a team, click on the team dropdown and then the  + New team button at the bottom of the list.
3. Name your new team.
4. Click `Create team.`

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FpRyzW6BwK9dvNFLVnQ3c%2Fadd-new-team.png?alt=media&#x26;token=77c677eb-1bd5-4a88-8052-8bb825f89234" alt=""><figcaption><p>Creating a team in a landscape</p></figcaption></figure>

To create an ownership team from the management page:

1. Navigate to the `Ownership teams` tab on the left.
2. Click the `+ New team` button.
3. Name your new team.
4. Click `Create team.`

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FddWu1Re3V1gE1yLxcMyv%2Fadd-new-team-org.png?alt=media&#x26;token=c5d6b607-380a-4ff9-b285-8a2c5d06aa83" alt=""><figcaption><p>Creating a team in the manage section</p></figcaption></figure>

## Adding people to a team

You can invite people in your organization to any team on the management or landscape page.

To invite people to a team:

1. Navigate to `Ownership teams` in the management or landscape page.
2. Select the team to which you want to add people from the dropdown.
3. Click the `Add team member` button.
4. Click `Add` on the people who you want to add to the team.
5. You can also use the search bar to find specific people.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FpskENQM8ikcIVTjiRt1x%2Fadd-team-members.png?alt=media&#x26;token=437f84d6-e25b-4fc8-9c99-af0ffc7b61d1" alt=""><figcaption><p>Adding people to a team</p></figcaption></figure>

## Removing people from a team

To remove people from a team:

1. Navigate to `Ownership teams` in the management or landscape page.
2. Select the team from which you want to remove someone in the dropdown.
3. Click the `Remove` button beside the team member.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FGRyxMcJctPlWRYRcYrMf%2Fremove-user.png?alt=media&#x26;token=c8000514-4536-4a0c-a7a0-048f9611c95b" alt=""><figcaption><p>Removing someone from a team</p></figcaption></figure>

## Assigning ownership teams to objects

You can assign an owner to your objects in a diagram or model view. This clarifies which teams are responsible for the object and see contact information (emails) of specific team members.

To assign an owner:

1. Select the object to which you want to assign an owner.
2. In the right-hand menu, click on the `Owners` field. By default, it'll be empty.
3. Select the team you want to assign ownership to. You can select more than 1 team.
4. Click on the dropdown icon of a team to see all team members (name, role). You can also copy their email address by hovering on the mail icon.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FC0lBXC3qY9BKE1dOY522%2Fassign-owners.gif?alt=media&#x26;token=66f4e24f-450c-4d8d-ad29-001579c34fde" alt=""><figcaption><p>Assigning an owner to an object</p></figcaption></figure>

## Viewing team objects

You can view all the teams' objects to get an overview of their scope within your landscape.

To see this:

1. Navigate to `Teams` from the landscape page or manage organization section.
2. Click the `View team objects` button.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2Fts9zb1OqhlRgr7BOqXPa%2Fview-team-objects.png?alt=media&#x26;token=83012ae6-33e1-4a8b-88cc-902d96de9de7" alt=""><figcaption><p>Viewing team objects from the landscape page</p></figcaption></figure>

## Deleting a team

To delete a team:

1. Navigate to `Teams` from the landscape page or manage organization section.
2. Click on the team dropdown.
3. Click the `…` button beside the team you want to delete.
4. Click the `Delete team` button.
5. Click the `Delete` button to confirm.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FTiQu13RqeCjxUTcvS1AL%2Fdelete-team.png?alt=media&#x26;token=d9523e43-4063-4f3a-8fe9-18330d4ad68b" alt=""><figcaption><p>Deleting a team from the landscape page</p></figcaption></figure>

## Locking object details from being edited

Object details such as their name, type, and status can be locked from being edited by non-owners. When you lock an object, only Admins and Owners can edit the details or delete it from your model. All outgoing connections from that object will also be restricted from being edited. Editors can still remove locked objects or their outgoing connections from the diagram.

To lock object details:

1. Select the object you want to lock.
2. In the right-hand menu, select the team(s) you want to lock edit access to in the `Owner` field.
3. Click on the `Editable by` field (by default, this is set to all editors) and change it to *Owners only.*

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FwwnlZmxC3GGTZbnbZh4w%2Fedit-owernship.png?alt=media&#x26;token=80846a32-1aa9-4917-a327-d4cecac31a80" alt=""><figcaption><p>Locking an object to owners</p></figcaption></figure>

{% hint style="info" %}
Locking an object to a team restricts non-owners from editing its details. However, nested objects will still be editable. For example, if you lock an app, other teams won't be able to change its name, but they'll be able to add, edit, or delete objects such as components within the app.
{% endhint %}

If you attempt to remove a team you're a part of as an Owner of a locked object, you'll see a confirmation prompt. Only do this if you're certain that you no longer need access to the object.  You'll need an Admin or another owner to give you access again.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FG4Um8LfUzcswLa6R56Op%2FScreenshot%202024-01-29%20at%202.41.27%E2%80%AFPM.png?alt=media&#x26;token=c16eb0be-d2c6-4d2a-9539-0ad82000f13b" alt="" width="375"><figcaption><p>Confirmation screen</p></figcaption></figure>

When non-owners view a locked object, they'll see a banner at the top of the details menu. They'll be unable to change or delete the object from the model.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FjY8t8toVBd12Mn2ZMbq9%2Flocked.png?alt=media&#x26;token=cd725ffa-c23c-463d-9ae2-04dd6d02c2c8" alt=""><figcaption><p>Locked object</p></figcaption></figure>
