Introducing Box configuration templates - Box types!

You can now save your favourite Box configuration as templates and use the Inheritance mode of popular features like Card Views, Quick Filters, Security, and more, to mange your Boxes more efficiently!

Click the links to learn more about Box types and other new features.


In general, information on Security settings can be found on following pages:

  • Box Types - this page contains information on configuring the default Security settings that work as a template when you create new Boxes and the Inheritance mode.
  • Global Roles - this page explains App Administration settings and how access to the App is granted to, for example, Jira users.
  • Box configuration - you are on this page. It explains what roles are available within the App and how to change them for an individual Box.
  • Technical Configuration of the App - this page gives you information on how to activate/deactivate use of roles within the App.
  • Security - this page explains the impact of setting up security Roles for the Home (root) Box and lists available roles.

On top of the Jira permissions and security settings, which are always respected by the App, you can grant security roles to individual users or to Jira user groups (creating groups requires Jira admin permissions). The roles can be defined for each Box separately or can be inherited automatically when you create sub-level Boxes.

Security and access

The Box security settings can be configured only when the 'Default Roles' option is selected in the App's technical configuration, otherwise, all users will be granted highest level permissions.

To change the assign security roles of a given Box, go to Box configuration > Security.

Only a user with the with a minimum Box admin security role can access and manage the Box configuration.

This configuration page will not be visible if the inheritance mode is set to "Inherited only" in the App's administration > Box types > Security.

The Inheritance mode depends on a Box type. When creating a new Box, you always have to select a type - security settings are copied, that includes the Inheritance mode and the role template. 

Inheritance of Roles

Security roles are always inherited from the upper-level Boxes, starting form the Root Box. This way, every time you create new Box it will inherit the Security Roles so that you do not need to assign them from scratch.

When you create sub-Boxes, the following roles are inherited:

  • Box Admin
  • Box Editor
  • Box Viewer

The sub-Box Creator is not inherited, as it would potentially allow users to create sub-Boxes  they can't delete. To find out more on the sub-Box creator role scroll down to the relevant section of this page. 

User roles inherited from upper-level boxes are not listed in Box Configuration > Security. They can be viewed only at the upper-level.

Default Box Type Roles

When you create a new Box, security roles are copied from a Box type role template. In settings of each Box type you can assign roles to users. Then, when you create a new Box, those user roles are copied. Users added based on the template are visible in the Box Configuration > Security section. 

To save time when assigning the Security Roles you can assign default roles in the Box type configuration.

Restricting access

App and Jira administrators have access to all existing Boxes. Users who lack access to a particular Box or, in other words, are not assigned to any security role, will not see the Box in the Overview module an in the Box switcher, unless a user has access to a sub-Box (but not to the upper-level Box), the upper-level Box will be displayed as a greyed out row (without links) to show the Box structure properly:



Security roles

RoleDescription
App AdminFull access to App Administration and all the Boxes (administrative access to all the Boxes)
App UserAccess to the App. Without additional Box Security Roles (listed below), doesn't have access to Boxes.



Box AdminAll operations within a Box and its administration.
Box EditorCan modify Box content, but can't access Box administration.
Box ViewerCan view contents of a Box.
Sub-Box CreatorCan create sub-Boxes nested under the Box, in which he/she has this role. Being a sub-Box creator doesn't grant an access to Box content or administration


Box Admin

Users or groups with this role have all the permissions granted, except for accessing the App's Administration page.

The Box Admin role is inherited by sub-Boxes.

As a Box Admin you can:

Besides editing the Box content as described in the Box editor role, as a Box Admin, you can change the Box configuration settings.

Due to the Inheritance mode, some Box configuration settings might be disabled or hidden. To change the inheritance mode .

Box Editor

This role is inherited by sub-Boxes. With this role you can:

Box Viewer

This role is inherited when you create sub-Boxes. Users or groups with this role can view the Box content in a 'read-only' way and will not have access to the Box configuration.

Sub-Box Creator

Use it to, for example, let users create Project Boxes as Sub-Box to a Portfolio Box.

This role is not inherited.

Constraints:

  • Only a Box admin can create a sub-Box using a Box type with "Inherited only" security mode
  • You cannot create a sub-Box, if later on you won't be able to delete it

For example, Angela has two roles in the AGILE project Box (editor + sub-Box creator). She tries to add an Iteration - she can't do it, if the security mode of the "Iteration" Box type is set up as "Inherited only". Adding a sub-Box with "Inherited only" security mode means that no new roles are granted for a sub-Box (a sub-Box admin can't be added during the creation process). She wouldn't be able to delete a sub-Box. Therefore, she cannot create a sub-Box.

If the "Iteration" Box type has the "Own with Inherited" security mode selected, she can create a sub-Box, because she will automatically become its admin. She can later delete it.

When Tom, a Box admin of the AGILE Box, tries to create a sub-Box, the security mode of the "Iteration" Box type doesn't restrict him. Even if a new Iteration will have the "Inherited only" mode selected for security, he can always delete a sub-Box, because he is the AGILE Box admin, and that automatically makes him a sub-Box admin.

Recommended use:

You can grant users a sub-Box creator role on the Home (root) Box level. As a result, they will be able to create their own Project Boxes, but won't be able to access or edit other Boxes nested in the Home Box. Sub-Box creators can then use Box types with "Own with inherited" security mode to set up new Boxes. Then, when they create a Box, they automatically become its admin.