---
title: "Manage teams"
canonical: "https://support.appfire.com/space/SPM/1918635643/Manage%20teams"
format: markdown
---
> Macro (aura-html)

## Manage teams (old navigation)

<details>
<summary>Expand</summary>

## Team attributes

Team codes are used to identify teams assigned to tasks by the BigPicture modules and, when synchronized, by Jira. A **team code** is not case-sensitive but will always be saved and displayed in capital letters. 

Each created team has a unique team code, which you need to specify when creating a new team.

### Configuration

Depending on [resources configuration](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918764262), a team code is stored as one of the following fields:

- Labels type
- Select list (single choice type)
- None (not synchronized)

> ℹ️ You can use these fields in your JQL to create quick filters or a Jira board dedicated to a specific team.

![Screenshot of the Team code field in the Teams module.](media://36002200-1629-4be4-a5e7-ce9728d86382)

Team codes are usually displayed next to the team name. For example, when you switch to the **Team** **view** in the Resources module, the team code is displayed next to each team name and in the task details dialog.

![Screenshot of the team code label in the Resources module.](media://6e51f56e-f7d6-4f87-a4d6-bb10f16b838b)

### Labels 

Labels are very convenient but prone to typos. BigPicture can automatically generate labels while you're assigning a team. The team code used as a label has the following format: **team#TEAMCODE**.

For example, Team Saphire uses the "SAPH" team code. The team label is added when you assign the team to a task.

![Screenshot of a Jira issue page with the team label field.](media://80d63e38-3a47-475b-a730-511eb8c7ba3c)

### Select list

**Select list **fields require you to predefine available options. When you use the **Select list** type field, only the TEAMCODE is used.

In the example below, the custom field labeled **Team code custom field** is populated with the Quality Assurance Team's code (QA).

![Screenshot of a Jira issue page with the Select list type field.](media://467bf31c-0a11-4f5b-8406-c680981c153d)

### Team board link

Team assignment **is NOT** synchronized with Jira. 

Use the **board link** to specify which Jira boards your teams use. This way, BigPicture can automatically create sprints on that board when you add a new synchronized box.

To learn more about synchronization, see the [the Work items from Jira](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=spm&title=Work%20items%20for%20Jira%20elements%20and%20actions&linkCreation=true&fromPageId=1918635643).

![Screenshot of the Board name column in the Teams module.](media://0add4d6b-bbae-499b-b29a-eecf124405a9)

#### Add Jira board link

To add a Jira board link to a selected team:

1. Go to the **Teams module** in BigPicture.
2. Click on the team to expand the **Details** sidebar.
3. Go to the **Details** tab.
4. Select a Jira board from the drop-down menu. The drop-down shows a list of previously created [Jira Scrum boards](https://support.atlassian.com/jira-software-cloud/docs/create-a-board/).
5. Click **Save**.
</details>

## Manage teams (new navigation)

<details>
<summary>Expand</summary>

## Team attributes

Team codes are used to identify teams assigned to tasks by the BigPicture modules and, when synchronized, by Jira. A **team code** is not case-sensitive but will always be saved and displayed in capital letters. 

Each created team has a unique team code, which you need to specify when creating a new team.

### Configuration

Depending on [resources configuration](https://appfire.atlassian.net/wiki/spaces/SPM/pages/1918764262), a team code is stored as one of the following fields:

- Labels type
- Select list (single choice type)
- None (not synchronized)

> ℹ️ You can use these fields in your JQL to create quick filters or a Jira board dedicated to a specific team.

![teams-code-color.png](media://222871b7-0a92-4e11-a8f1-45e153385395)

Team codes are usually displayed next to the team name. For example, when you switch to the **Team** **view** in the Resources module, the team code is displayed next to each team name and in the task details dialog.

### Labels 

Labels are very convenient but prone to typos. BigPicture can automatically generate labels while you're assigning a team. The team code used as a label has the following format: **team#TEAMCODE**.

For example, Team Saphire uses the "SAPH" team code. The team label is added when you assign the team to a task.

![Screenshot of a Jira issue page with the team label field.](media://80d63e38-3a47-475b-a730-511eb8c7ba3c)

### Select list

**Select list **fields require you to predefine available options. When you use the **Select list** type field, only the TEAMCODE is used.

In the example below, the custom field labeled **Team code custom field** is populated with the Quality Assurance Team's code (QA).

![Screenshot of a Jira issue page with the Select list type field.](media://467bf31c-0a11-4f5b-8406-c680981c153d)

### Team board link

Team assignment **is NOT** synchronized with Jira. 

Use the **board link** to specify which Jira boards your teams use. This way, BigPicture can automatically create sprints on that board when you add a new synchronized box.

To learn more about synchronization, see the [the Work items from Jira](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=spm&title=Work%20items%20for%20Jira%20elements%20and%20actions&linkCreation=true&fromPageId=1918635643).

![teams-board.png](media://1f6e28e4-0b83-4711-8181-842cc34fc146)

#### Add Jira board link

To add a Jira board link to a selected team:

1. Go to the **Teams module** in BigPicture.
2. Click the team to expand the **Details** sidebar.
3. Go to the **Details** tab.
4. Select a Jira board from the drop-down menu. The drop-down shows a list of previously created [Jira Scrum boards](https://support.atlassian.com/jira-software-cloud/docs/create-a-board/).
5. Click **Save**.
</details>