Bamboo permissions

Bamboo provides the following types of permissions to allow fully customizable control of access to the continuous delivery workflow:

  • Global permissions
  • Build plan permissions
  • Project permissions
  • Deployment permissions
    • Deployment project permissions
    • Deployment environment permissions

Permissions key:

(tick) - Permission is set by default

(star) - Permission is available as an option

(error) - Permission not available, even as an option

On this page:

Starting from Bamboo version 6.2, permissions become additive. Once you’re assigned permissions on any level, you'll automatically have permissions on lower levels. You can’t override or remove permissions on lower levels. For example, if you have  Create permission of a global level, you can create plans on all levels. Another example, if you have  Build permission assigned to you on a project level and none assigned on the plan level explicitly, you will still have build permissions for that plan anyhow.

Global permissions

Global permissions level control the ability to view the system, create a new build plan and use administration tools. Global application permissions are accessed from the Global permissions page within the Bamboo administration pages.

User type Access Create Create repository Restricted admin Admin
Anonymous (tick) (error) (error) (error) (error)
Logged-in (tick) (error) (star) (star) (star)
Administrator (tick) (tick) (tick) (star) (tick)


  • Access - log in to Bamboo; this permissions does not give you any additional permission. 
  • Create - create new plans, projects and deployment projects in Bamboo. 
  • Create repository - create and manage linked repositories.
  • Restricted admin - perform some administration operations and view all plans in Bamboo; this role excludes permissions that directly influence the host on which the Bamboo Server is located, however, all plan administration and agent administration is available to restricted admins.
  • Admin - perform all operations and view all plans in Bamboo.

Build plan permissions

Build plan permissions allow a user to control access to the functions of the build plan. These include viewing, editing, building, cloning and administering a build plan. Build plan level permissions are accessed from the build plan configuration page. 

User View Edit Build Clone Admin
Anonymous (star) (error) (error) (error) (error)
Logged-in (star) (star) (star) (star) (star)
Administrator (tick) (tick) (tick) (tick) (tick)


  • View - view the plan and its builds; when creating a new plan, check the  Allow all users to view this plan to allow anynymous and logged-in users view your plan.
  • Edit - view and edit the configuration of the plan and its jobs, not including permissions or stages.
  • Build - trigger a manual build, or suspend and resume the plan.
  • Clone - clone the plan.
  • Admin - edit all aspects of the plan including permissions and stages.

Project permissions

Project permissions allow you to control access to project permissions and settings. See Configuring project permissions.

User Create plan Admin
Anonymous (error) (error)
Logged-in (star) (star)
Administrator (tick) (tick)


  • Create plan - create plans for the project

  • Admin

    • manage permissions for the project

    • manage permissions for all plans in a project

    • change project settings

Deployment permissions

Bamboo's deployments features allow you to control permissions for both deployment projects and deployment environments.

Deployment projects

User View Edit
Anonymous (tick) (error)
Logged-in (tick) (star)
Administrator (tick) (tick)


  • View - view the project and its associated environments.
  • Edit - edit the project, its related plan and environment configuration, and create releases.

Deployment environments

User View Edit Deploy
Anonymous (tick) (error) (error)
Logged-in (tick) (star) (star)
Administrator (tick) (tick) (tick)


  • View - view the project and its associated environments. You must also have view permission on the deployment project.
  • Edit - edit the environment.
  • Deploy - deploy releases to this environment and create releases for this project.

Permission dependencies

To ensure the consistency of Bamboo permissions, starting with Bamboo 6.3, we provide an update mechanism which will fix all inconsistencies for all permissions in your Bamboo environment. We have also modified all the pages where you can edit permissions in a way which won’t allow granting inconsistent or clashing permissions in the future.

If you want to revoke a lower-level permission for a user, you must revoke the higher-level permissions first. Also, when granting a higher-level permission to a user, all relevant lower-level permissions will be granted automatically to that user.

Permission consistency might still be broken when using third-party plugins.

Last modified on Dec 20, 2017

Was this helpful?

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