Define Families

This tab allows you to define your own families. You can later add them to the Family Scanner  and Family Browser  results using the Add Predefined Families button at the upper-right corner of the family set.

Adding a project

To add a project to your family click Add project button in the bottom-right corner of the family panel. A box is displayed allowing you to choose a project from a list of projects.

You cannot add the same project multiple times. If you try to add the same project the following error message appears in the dialog box:


Adding a permission

On Expand you can see the permissions and sources of the family and add  permissions and sources for those permissions.  

To add a permission click Add Permission link in the expanded table for the corresponding project or global permissions.  A dialog is displayed allowing you to choose a permission.

The dialog for adding Global Permissions looks like this:

The Project Permissions dialog allows you to choose the permission category and then a permission from that category.

After adding the permissions, the family looks like this:

For each permission you have two options:

  • Delete  - remove the permission with all its sources.  
  • Add Permission Source - add more sources for that permission.

Adding permission sources

You can choose the sources for permissions from the dialog displayed when click the Add Permission Source link.

The dialog for Global Permissions looks like this:

Global permissions are only granted to groups of users.

Project permissions can be granted to:

  • Individual users (Direct permission source)
  • Groups
  • Project Roles

The dialog which allows you to add sources for the project permissions is presented below:


Adding permission sources that do not exist is granted when the first user is assigned to the family. For example, we have no Browse Project permission for the jira-users group. However, we add this as a permission source in one of the predefined families. When a user is assigned to the family, the Browse Project permission is granted to the jira-users group. This can impact other families and permissions, so use this feature with care.

For more information about permission sources, see User guide.

Deleting a permission source

After adding the permission sources the family looks similar to the one below:

You can remove a permission source by clicking the red marker.

Saving your family

You can save your families by clicking Save button at the bottom of the page. In the Family Scanner and Family Browser tab you are able to add them using  Add Predefined Families button at the upper-right corner of the family set. The family is saved with the default name ("Your family name"), unless you change it before saving.


To rename a family, see Managing Families.



You cannot save the family if you defined permissions with no sources.