Setup

Applies to: Jira Data Center

After installing Sort by Any Field via the Universal Plugin Manager (UPM), make sure the following prerequisites are in place:

1. Confirm the board’s filter query ends with ORDER BY Rank ASC

   The app relies on Jira’s native ranking. The board filter must finish with ORDER BY Rank ASC so that the sorter can adjust the existing rank in the background.

   • How to check your board’s filter query

     1. Open the target Jira board.
     2. Choose Board → Configure.
     3. In General and filter, review the Filter Query field.
     4. Confirm the filter query ends with ORDER BY Rank ASC (screenshot). If the clause is missing, append it to your current query (for example, project = FOO ORDER BY Rank ASC).

   • Why this matters: Without the rank ordering, the sorter cannot reliably promote issues, and the background job may appear to finish without applying the expected order.

2. Grant users the “Schedule Issues” permission

   Sorting is executed by re-ranking issues. Users must be allowed to rank issues on the board.

   • How to grant the permission
     1. Navigate to Project settings → Permissions.
     2. Edit the project’s permission scheme.
     3. Add the Schedule Issues permission to the groups or roles who will trigger sorts (screenshot).

3. Verify the installation is licensed

   The app surfaces a warning banner when it is unlicensed. If that message appears, work with your Jira administrator to activate the license before attempting a sort.

Once these prerequisites are met, open the Sort Board / Sort Backlog / Sort Sprint action, configure your “Order by” clauses, and run the sort. Jobs execute asynchronously; the modal will display status updates until completion.