# Team

<img src="/files/3ZSrh6w3ZHxuG4xLqPzC" alt="Teams can contribute to multiple programs (release trains) at the same time." width="375">

Only *Ativo Programs for Jira* **administrators** can create, edit and delete teams ([more info](/configuration/permissions.md)).

Ativo Agile Programs for Jira uses its own team configuration. Jira cloud also has team definitions, but these do not contain the necessary scope information. Sorry 🧡.

You can align with the "Advanced Roadmaps / Plan" team definitions (included in Jira Premium and Data Center) by referring to the the Jira boards or JQLs in Ativo.&#x20;

### Create a new team (based on a Jira board)

To create a new team, using a Jira board:

* Open Ativo Programs&#x20;
* Click on ***Settings*** and then on **Teams**
* Click on the **Create Team** button
* Select the dedicated **Jira board** that the team is using. Ativo will use the Jira filter of the board as the scope for the team, as well as the board mode and estimation settings.
* Click **Create**

<figure><img src="/files/YykXuWQylRqB77lCqEHb" alt=""><figcaption></figcaption></figure>

### Supported Jira boards

A Jira board is supported if it:

* Has a [JQL filter that is supported in Ativo](/configuration/project-and-jira-jql-filters.md)
* Is a Scrum or Kanban board
* Has an estimation that is either Story Points, Man Days or Issue Count. When using Story Points, all Ativo teams should use the same Jira field. A Jira admin can select the Story Points field to use in Jira via (Jira settings > Apps > Ativo Programs > Fields ). If not selected, the default Jira Story Points field is assumed.\ <br>

  <figure><img src="/files/u34yhpBwgDzw3rbJRBN0" alt=""><figcaption><p>Jira admins can set the Story Points field to use in Ativo.</p></figcaption></figure>

### Create a custom team

Create a 'custom team' if the team is not using a dedicated Jira board (e.g. no board exists, or it is shared with multiple teams).&#x20;

To create a custom team, do the same steps as above when creating a team using a Jira board. When the modal is open, select ''

* Open Ativo Programs&#x20;
* Click on ***Settings*** and then on **Teams**
* Click on the ***Create Team*** button
* Fill in the configuration information (see below)
* Click **Create**
* Click **Submit** (on the main team overview page)

Configure a new team:

* **Team name** - used as a label, e.g. on the program board.
* **Team key** - used when importing / exporting data. Choose something meaningful.
* **Mode** - set to *Scrum* or *Kanban.* With *scrum*, a team will plan stories in sprints. With *Kanban*, the *due date field* is used instead to map stories to sprints at program level.
* **Estimation** - set to *Story Points*, *Man Days* or *No estimations*, depending on how the team estimates work. Each team can use its own estimation method. Totals at feature and program level will be consolidated with a standard conversion rate of 1 MD = 1SP for teams using man days, and 1 ticket = 1 SP for teams not using estimations.
* **Jira filter (scope)** - let Ativo know which Jira issues the team is working on. the scope can be defined as a Jira projects (in case each team has a separate project), or a more complex filter in case teams are working on multiple projects, or are sharing Jira projects.&#x20;

{% hint style="info" %}
If you haven't decided on how to structure team scopes yet in Jira, we suggest to use a “one Jira project per team” configuration. This allows you to create flexible and agile workflows for each team.&#x20;
{% endhint %}

<figure><img src="/files/VtPZAwEkaWsoh8HKsgTc" alt="" width="563"><figcaption><p>Team creation form</p></figcaption></figure>

### Switch between "Jira board" and "custom" team configurations

You can switch a team configuration from 'Jira board' to 'custom' and vice-versa. To update an existing team, click on the 'more' and then 'edit' button of the team. Then click on 'Configure team in a custom way' or 'Configure team using a Jira board'.

How to tell the difference between both configurations? Teams configured using a 'Jira board' have a 'Jira board' selection. Teams configured in a custom way do not refer to a 'Jira board'.

When possible, use a 'Jira board' configuration, as it allows for a faster sprint selection in the Period configuration screen.

<figure><img src="/files/YDsWrp5Gz5DnCI4KYeaH" alt=""><figcaption><p>Edit a team configuration</p></figcaption></figure>

<figure><img src="/files/0ReWQ3ScEluuQW2pX3rm" alt="" width="563"><figcaption><p>Switch from 'Jira board' to 'custom' team configuration</p></figcaption></figure>

<figure><img src="/files/Zr9XLMS7Orq0N8TxUJ8x" alt="" width="563"><figcaption><p>Switch from 'custom 'to 'Jira board' team configuration</p></figcaption></figure>

### Archive a team

Archiving a team will remove the team from all programs and all periods.&#x20;

To archive a team:

* Click on the more options button and then on archive.
* Confirm you want to archive the team.
* Click on ***submit***

<figure><img src="/files/A0WyHuBUydXGdV1BEGJL" alt=""><figcaption><p>Archive a team</p></figcaption></figure>

You can unarchive an archived team by clicking on the more options button and then selecting unarchive.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ativo.io/configuration/team.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.