Permissions in Portfolio for Jira

Still need help?

The Atlassian Community is here for you.

Ask the community

Global permissions

To use Portfolio for Jira, a Portfolio for Jira administrator must grant you access to the add-on first, via the global permissions in your Jira application. See Managing global permissions for more information.

You need to configure permissions, to ensure that users have access to the correct plans and programs in Portfolio for Jira, as necessary.

Note that the permissions in Portfolio for Jira take precedence over the global permissions in your Jira application.

User permissions

Permission Details
Portfolio for Jira administrator

Ability to perform all administrative functions in Portfolio for Jira. By default, Jira application administrators are automatically made administrators in Portfolio for Jira.

Portfolio for Jira user

Ability to create, view, and edit public plans and programs.

Note that this permission at both the program level and the plan level are independent of each other. This means that even if you can edit the 'Mobile expansion' program, you still need this permission to view and add the 'Beta' plan to that program.

Portfolio for Jira viewer

Ability to browse and view plans in read-only mode.

Note that this permission at both the program level and the plan level are independent of each other. This means that even if you can view the 'Mobile expansion' program, you still need this permission for a particular plan to view that plan in the 'Mobile expansion' program.

Portfolio for Jira Labs
Ability to access and use the Labs features of Portfolio for Jira features that are in Labs mode

Portfolio for Jira restricted user
(applies only to Portfolio for Jira classic plans)

Includes all of the abilities of the Portfolio for Jira user; however, users with this role are not permitted to update issues in Jira projects from within Portfolio for Jira.
Shared team management
Ability to access global team management and edit teams that are shared across plans and programs in Portfolio for Jira

Plan permissions

The permissions in Portfolio for Jira take precedence over the permissions in your Jira application. This means that even if you're a project administrator in your Jira application, you'll still need specific permissions in to perform specific actions with the plans in Portfolio for Jira.

The following plan permissions are available in Portfolio for Jira.

Plan permission View plan Edit plan Delete plan Modify issues
in plan
Viewers (tick) (error) (error) (error)
Editors (tick) (tick) (tick) (tick)

Program permissions

By default, all Portfolio for Jira users in your Jira application instance can view and edit a newly created program. However, as soon as view permissions (Portfolio for Jira viewer) or edit permissions (Portfolio for Jira user) for that program are assigned to any user, the program then becomes restricted to that specific user.

Note the following details:

  • If you don't have view permissions for a program, you won't be able to see that program in Portfolio for Jira.
  • To add a plan to a program, you must have view permissions for that plan.
  • If you can view a program, but you don't have view permissions for a plan, you won't see the plan or any issues from that plan in Portfolio for Jira.

The following table lists how user permissions work when you're performing specific actions involving plans and programs.

User permission

Actions when configuring a program (at the program level)

Plan permission Program permission Add plan to program View plan in program Remove plan from program
None None (error) (error) (error)
View None (error) (error) (error)
Edit None (error) (error) (error)
None View (error) (error) (error)
View View (error) (tick) (error)
Edit View (error) (tick) (error)
None Edit (error) (error) (error)
View Edit (tick) (tick) (tick)
Edit Edit (tick) (tick) (tick)

Note that Portfolio for Jira administrators are able to grant themselves the View and Edit permissions for public plans and programs.

Related topics

Last modified on Apr 3, 2018

Was this helpful?

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