How to restrict editing of an issue in a specific status

Still need help?

The Atlassian Community is here for you.

Ask the community

This article requires fixes

This article has been Flagged for fixing. Use caution when using it and fix it if you have Publisher rights.

Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.

Summary

This article provides the steps to allow only users belonging to specific groups or project roles to edit the issue at a given status.

For example, we want only the admins to be able to edit an issue once its moved to In Progress status.


Environment

Jira Cloud

Solution

This can be achieved using the workflow properties. Please follow the below steps:

  1. Go to Project --> Project settings --> Workflow --> Edit.
  2. Select the required status which has to be set as uneditable.
  3. Click on Properties. (Make sure to edit the status property and not the transition property).


  4. In the new window that comes up, set one of the following:
    1. To limit the edition based on Project roles:
      1. Property key = jira.permission.edit.projectrole
      2. Property value = ID of the target_role
    2. To limit the edition based on Groups:
      1. Property key = jira.permission.edit.group
      2. Property value = target_group
    3. To limit the edition for a specific user:
      1. Property key = jira.permission.edit.user
      2. Property value = target_user
  5. If required, you can restrict all users (including admins) from editing the issue using the following property values:
    1. Property key = jira.permission.edit.denied
    2. Property value = leave empty
  6. Then publish the draft workflow.

How to get the ID of a project role:

When using the project roles in the above configuration, the actual names of the project roles won't work and you need to provide the ID of the project role.
To retrieve the ID, please navigate to Settings (cogwheel icon on the top right) > System > Project roles and click Edit against the project role whose ID you're looking for. The ID can now be copied from the URL.

 

Important information about using usernames in the above configuration

When using a username, jira.permission.edit.user might not work as expected. This is because the usernames were deprecated from the Jira UI due to privacy restrictions. The issue is that the "jira.permission.edit.user" property still expects usernames. We have an open bug to rectify this behaviour.

As a workaround, you may add the required user(s) to a group and use the group property stated above.



Last modified on Jan 22, 2025

Was this helpful?

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