Last updated Aug 25, 2023

Manage app contributors

When managing contributors of your app, you must first ensure you're that happy with the roles and permissions you’re giving them access to.

This page explains how to add contributors, edit roles of contributors, view contributor history, view deployment history, manage app environments, and transfer app ownership in the developer console.

Only app admins can add, edit, and remove contributors.
Contributors will receive an email notification when they are added to or removed from an app.
Contributors are able to see the public name of other contributors in the developer console. They can also see their email address, depending on the contributor’s privacy settings.
Contributors are able to see their role in the Contributors panel of the Overview page.

View contributors

To view the contributors of an app:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.

Add contributors

When adding a contributor to an app, the contributor will gain permissions to access the app via the Forge CLI and developer console, depending on the role selected for them.

To add a contributor to your app:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.
Select Add contributors above the table.
Enter the email address of the contributor you're adding to the app.
Select the role that you want to set for the contributor.
Select Add.

You can also add multiple contributors by adding and separating their email addresses with a comma. Only 10 contributors can be added to an app at a time.
When selecting a role for multiple contributors, note that you're setting the same role for all contributors. If you want the contributors to have different roles, we recommend adding them individually.
You can optionally provide the advanced permission view production logs to a contributor of the viewer, deployer, or developer role. See app monitoring activities to know more.

Edit the roles of contributors

To edit the role of a contributor:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.
Select the More actions (⋯) menu for the contributor whose role you're editing.
Select Edit role.
In the popup that appears, select the new role.
Select Save changes.

You can edit the roles of multiple contributors by selecting the checkboxes of the relevant contributors and selecting Edit role.
When selecting a role for multiple contributors, note that you're setting the same role for all contributors. If you want the contributors to have different roles, we recommend editing them individually.
You can optionally provide the advanced permission view production logs to a contributor of the viewer, deployer, or developer role. See app monitoring activities to know more.

Remove contributors

To remove a contributor from an app:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.
Select the More actions (⋯) menu for the contributor whose role you're editing.
Select Remove.
In the popup that appears, confirm the removal by selecting Remove.

You can remove multiple contributors by selecting the checkboxes of the relevant contributors and selecting Remove. In the popup that appears, confirm the removal by selecting Remove.

View contributor history

Only app admins can view contributor history and manage contributors.

To see which contributors have been added, edited, or removed from your app:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.
Select the Activity tab.

Contributors activity screen

The screen shows when contributors have been added, changed, removed, or changed to app owner. It also shows who completed the action.

You can narrow the list down using the filters above the table.

By default, the table is sorted by Date/Time (UTC), with the most recent actions appearing at the top.
The contributor name or email filter only shows contributors who have been added or removed since this functionality was released. You can work around this limitation by removing and adding the contributors again - they will then appear in the filter.

View deployment history

To view the deployment history for your app:

Access the developer console.
Select the relevant Forge app.
Select Deployments in the left menu.

Deployments screen

The screen shows a list of recent deployments, across all contributors, as well as environments and versions. You can narrow the list down using the filters and search bar above the table.

Manage environments

Only app admins, deployers, and developers can create and delete a custom development environment.

When you add a contributor, a new development environment is created for them.

To view the environments for all contributors:

Access the developer console.
Select the relevant Forge app.
Select Environments in the left menu.

Environments screen

To delete an environment, select Delete under the Actions column.

Transfer app ownership

Only app owners can transfer app ownership.
The new app owner will receive an email notification.
To transfer ownership, an app must have at least one contributor apart from the app owner.

To transfer ownership of your app:

Access the developer console.
Select the relevant Forge app.
Select Contributors in the left menu.
In the Actions column next to your name, select Change owner.
Follow the instructions to select a new owner.
If you’re happy with the new owner, select Confirm transfer.

You can also transfer ownership from the Settings screen of the app.
If the app owner is unavailable, contact Atlassian support to assist you with transferring app ownership.
If a contributor’s Atlassian account gets deactivated or deleted, they will still remain a contributor of the app. The app owner will have to manually remove them as a contributor.