Creating teams

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Before you begin

The teams field is actually a custom field in Jira. To make this field appear in Jira issues, you'll first need to add this custom field to the screen that's being used in the corresponding Jira project.

To do this:

  1. In Jira, click  > Issues.
  2. Click Custom fields.
  3. Find the Team field in the list of fields.
  4. Click  for the team field > Screens.
  5. Select the screens you want to add the team field to.
  6. Click Update.

Each time a team is assigned to an issue in your plan, and you save this change to Jira, the team field will appear in the corresponding issue in Jira.

Creating teams in a plan

Portfolio for Jira lets you play with what-if scenarios, to see if any team changes have any impact on planned work. 

Teams can either be private or shared across plans. The main difference here is you can assign a shared team to work across multiple plans. A private team can only be assigned work that's in the plan in which the team itself is created.

If there are no teams existing in your plan yet, you'll be prompted to start creating a team.

Sample plan, with no teams added to it yet

Note that you need the Portfolio for Jira user permission to save team changes in Jira.

Creating a private team in a plan

When creating a private team, you're essentially creating a new team for the plan. The newly created team will only exist for this specific plan.

To create a private team:

  1. In the teams view of the plan, click + Create team. This will display the 'Create team' dialog.
  2. Choose New private team.
  3. Give the new private team a name.
  4. Choose the issue source that you want to associate with the team. The issues of the selected issue source will be prioritized for this team. We recommend that you use Scrum boards. When using a Scrum board, note the following:
    • Portfolio for Jira can use the velocity of past sprints to determine team velocity.
    • You can choose to display the sprints of the Scrum board in your plan. See Grouping issues by teams to know more.
  5. Choose from the following team types:
    • Scrum— for teams that plan their work in sprints. More about Scrum
    • Kanban— for teams that focus on managing and constraining their work-in-progress. More about Kanban
    (info) The type of team you choose will have an impact on how capacity is handled and managed in a plan. See Managing capacity to know more.
  6. Depending on the team type and estimation unit...
    • If you're creating a Scrum team that uses story points estimates, specify the sprint velocity and sprint length.
    • If you're creating a Scrum team that uses time-based estimates, specify the weekly capacity and iteration length.
    • If you're creating a Kanban team, specify the weekly hours for the team capacity.
  7. Choose the members to add to the team.
  8. Click Create.
  9. Save the changes by doing the following:
    1. Click Review changes. The 'Review changes' dialog will display, with all changes selected by default.
    2. Make sure the checkboxes for the team changes are selected, then click Save selected changes in Jira.

    You need the Portfolio for Jira user permission to save changes in Jira.

Adding a shared team to a plan

When adding a shared team to a plan, you're essentially adding an existing shared team to the plan. The shared team should already exist in Portfolio for Jira.

Note that creating shared teams can only be done from the 'Shared teams and people' window. See Managing shared teams for more details.

To add a shared team to a plan:

  1. In the teams view of the plan, click + Create team. This will display the 'Create team' dialog.
  2. Choose Add existing shared team.
  3. Choose the shared team to add to the plan.
  4. Click Add shared team.
  5. Save the changes by doing the following:
    1. Click Review changes. The 'Review changes' dialog will display, with all changes selected by default.
    2. Make sure the checkboxes for the team changes are selected, then click Save selected changes in Jira.

    You need the Portfolio for Jira user permission to save changes in Jira.

After adding a shared team to a plan, you'll still need to choose an issue source for the shared team. See Editing teams for more details.

Last modified on Dec 30, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.