Restrict new labels creation
- Atlassian
Colored Label Manager gives you full control over your Jira labels. You can restrict label fields to ensure users select only predefined labels, maintaining consistency and organization. Alternatively, you can keep label fields open for flexibility, allowing teams to create labels on the fly. With support for multiple label fields, you can manage and color-code them effortlessly, transforming your Jira boards into a visually structured and highly efficient workspace.
Introduction
Label fields can be used either as labels or select list fields, depending on their configuration and specific use case.
As a label, the label field simply displays text or data, providing information without requiring user interaction.
As a select list field, it presents a dropdown list or predefined options for users to choose from.
This flexibility allows label fields to serve multiple purposes within applications or forms.
In each project's label configuration, you will find all Jira label fields that have been created by the Jira administrator using our App.
As a Project administrator, you can restrict a label field to prevent users from creating new label items , Instead, they will be required to select from existing ones.
As a Project administrator, you can define label items and prevent users from creating new ones, ensuring they use only the predefined labels
This ensures consistency across fields such as Definition of Done (DoD), Definition of Ready, Acceptance Criteria, or simple select lists.
How to Configure Label Restrictions
Jira administrator create the needed label fields
Project administrator go to the project and click on Settings.
Navigate to Colored Labels Configuration.
Choose the label field you want to restrict or unrestrict.
In this case, the Customer field is restricted , so Users can only consult list of customers and use them in their tickets (You should see something like this):
How to Add label items
As a Project administrator, you can add label items to your label field
In our case we want to add items to the label field Customers :
Go to your project.
Click on Project Labels.
Select Customers in the label field.
Define the name, description, and color, then click Add Label.
As we did previously, we have already restricted the Customers label field for users.
Project administrator can also define new label items in the Issue view
Click on the label field “Customers” :
Click on Icon “+” :
Choose the name of new label item and the color , after that click on Add then Submit :
What users see if a label field is restricted
If the label field is restricted and label items are defined by the project administrator, users will see something like this in the issue view:
Project labels view
The panel for adding labels is blocked, and a message appears: "You do not have permission to add labels."
Issue view (by clicking on the label field)
They are required to choose from existing label items and cannot create new ITEMS , even in the issue view. (The + button will not display for users who are not project administrators )
Note: If the label field is not restricted, any user in the project can add new label items—either through the project label view or directly within the issue view.
Conclusion
Only a Jira administrator has the ability to create a new colored label fields. However, both Jira administrators and project administrators can add items to a restricted label field, ensuring controlled and consistent label management. If the label field is not restricted, all project users will have the flexibility to add new labels as needed.
Need help?
Please raise an issue in our Help Center in case of questions or to report a bug, we are here to support you.