This page last changed on Oct 16, 2008 by alui.
A plan permission is the ability to perform a particular operation in relation to a build plan. For each plan, different permissions can be granted to particular groups and/or users.
The following plan permissions are available:
Plan permission |
Description |
Can be granted to |
'View' |
Permission to:
- view this plan's build results
- add comments or labels to this plan's build results¹
 | People who don't have the 'View' permission will not know that the plan exists. |
|
- a particular user
- a particular group
- all logged-in users
- anonymous users² |
'Edit' |
Permission to view and edit this plan's configuration, except for the plan's permissions. |
- a particular user
- a particular group
- all logged-in users
- anonymous users² |
'Build' |
Permission to:
- manually start/stop a build for this plan.
- enable/disable this plan from submitting builds to the queue.
|
- a particular user
- a particular group
- all logged-in users
- anonymous users² |
'Clone' |
Permission to copy this plan when creating a new plan.
(Note: only users with the 'Create Plan' global permission can create new plans.) |
- a particular user
- a particular group |
'Admin' |
Permission to:
- edit this plan's permissions.
- delete this plan's build results and working files.
|
- a particular user
- a particular group |
¹ Only logged-in users (not anonymous users) can label or comment on a build result.
² Anonymous users cannot access Bamboo at all unless they have been granted the 'Access' global permission. See Allowing Anonymous Users to access Bamboo.
 | Anyone with the 'Admin' global permission automatically has all plan permissions for every plan. |
The processes for granting and revoking plan permissions are described below. Note that, for ongoing ease of management, it is recommended that you grant permissions to groups rather than to individual users.
To grant plan permissions to a user,
To grant plan permissions to a group,
To grant plan permissions to all Bamboo users,
If you are creating a new plan, start at step 5.
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
- Locate 'Logged in users' (under 'Other').
- Select the check-box for each permission that you wish to grant to all Bamboo users.
- Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).
To grant plan permissions to anonymous users,
If you are creating a new plan, start at step 5.# Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
- Locate 'Anonymous users' (under 'Other').
- Select the check-box for each permission that you wish to grant to all anonymous users.
- Click the 'Save' button if you are editing an existing plan; or if you are creating a new plan, click the 'Next' button and go to Completing and Enabling a New Plan (hidden).
To revoke plan permissions,
Screenshot: Plan Permissions

|