Create and manage an Atlassian team

Go to the Teams dropdown in the navigation and select Create team. You can also select Create team from the people directory page, which you can find by selecting Search people and teams in the Teams dropdown.

Choose a name for your team and invite other Atlassian users to become part of your team. Once your team has been created, organization admins and team members will have the same permissions as you do. They can:

  • Change header image

  • Accept/Decline membership request

  • Add members

  • Remove members

  • Edit team name

  • Edit team settings

  • Edit team description

  • Add links

  • Delete team

Users must have Browse Users and Groups global permission before they can add members or make changes to a team.

Unlike organization admins, site admins don’t have these same permissions and must become a member of a team before they can make any changes. Site admins will still need to join a team before they can add or remove members.

Understanding membership controls

For teams with invite-only membership, people can only join by receiving an invite from an existing member or by requesting to join. For teams with open membership, anyone can join from the profile.

Managed teams do not have configurable membership, since the connected group serves as the source of truth for membership.

To change membership type for a team:

  1. From the team profile page, select the menu icon next to Add people.

  2. Select Team settings.

  3. Select or clear the checkbox under Membership controls.

    1. Selecting the box will enable anyone to join the team without needing an invite or approval.

    2. Clearing the box means people will need to request approval or get an invite from an existing member.

Who can manage and change the team?

Based on the team configuration and membership configuration, only certain people can change the team settings, membership, and profile.

 

Team with invite-only membership

Team with open membership

Managed team

Create team

Anyone

Anyone

Org admins via Atlassian administration

Delete team

Team members and org admins

Anyone

Org admins via Atlassian Administration

Add members

Team members and org admins

Anyone

Org admins but via through a group, whose membership is the source of truth

Remove members

Team members and org admins

Anyone

Org admins but via through a group, whose membership is the source of truth

Accept/decline membership request

Team members and org admins

Anyone

N/A - people cannot request to join a managed team.

Edit team name

Team members and org admins

Anyone

Org admins via Atlassian Administration

The team name will be derived from the connected group.

Edit team settings

Team members and org admins

Anyone

Org admins

Edit team description

Anyone

Anyone

Anyone

Change header image

Anyone

Anyone

Anyone

Add links

Anyone

Anyone

Anyone

Create a new team on behalf of others

Users who create a new team have the option to remove themselves as a member. Previously, any user who creates a new team becomes a member by default.
To create a new team and remove yourself as a member:

  1. Select Teams from the top menu.

  2. Select Create team.

  3. Under Invite people to your team, select X beside your name.

Note that there must be at least one person listed as a member before a team can be created.

Add or remove members of a team

Organization admins and team members have the same permissions, so they can invite new team members or remove existing team members.

When you add someone to the team they will see the team profile page, but they will only see recent work that has been shared with them or that they have collaborated on.

Managed teams

Membership is synced with the group that’s connected to the team. If an organization admin adds or removes a person from the group, that person will be added or removed from the connected team. No one can add a member to a managed team outside of the group.

Note: You can only add members of your organization to your team.
What is an Atlassian organization?

Share content with a team, or @mention a team to notify them

Once you have created your team, you can share content with team members, or @mention the team on pages or issues to notify everyone in the team.

To share with a team, click the Share button in the top navigation of Confluence, or the share icon on a Jira issue and enter the team’s name. Members of the team will be notified by email or through their in-app notifications.

You can also @mention your team's name on a page or issue to notify everyone in the team. When using autocomplete to find the team name, the suggestions may include teams whose profile description contains the word or phrase entered.

Note that managed teams will be indentified with a blue verified checkmark icon.

Delete a team

Note: You can only delete a managed team through the group itself. Learn more here.

Once you've deleted a team:

  • All items in the team profile page will be removed, including the:

    • team name

    • description

    • members

    • header image.

  • All members will lose access to the team.

  • You can't share to the team or mention the team.

  • The team will not appear in search results across Atlassian products.

Here’s what might be impacted:

  • Issues

  • Goals

  • Projects

  • Alerts

  • Integrations

  • Schedules

  • On-call settings

  • Components

  • Automations

To delete a team:

  1. From the team profile page, select the menu icon next to Add people.

  2. Select Delete team.

How-to-delete-a-team

Reactivate a team

After you delete a team, team members and the org admin will receive an email on how to reactivate limited team information within 30 days.

To reactivate a team:

  1. View the team page.

  2. Select Reactivate.

This action will restore the team name, description, members, and the header image.

Some existing connections and work linked to the deleted team may also be recovered. However, you’ll need to reconfigure connections that are permanently lost.

Still need help?

The Atlassian Community is here for you.