info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
info:To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---
---
# Sorting and ordering issue lists
# Sorting and ordering issue lists **(CORE)**
You can sort a list of issues several ways, including by issue creation date, milestone due date,
You can sort a list of issues several ways, including by:
etc. The available sorting options can change based on the context of the list.
- Blocking
- Created date
- Due date
- Label priority
- Last updated
- Milestone due date
- Popularity
- Priority
- Weight
The available sorting options can change based on the context of the list.
For sorting by issue priority, see [Label Priority](../labels.md#label-priority).
For sorting by issue priority, see [Label Priority](../labels.md#label-priority).
In group and project issue lists, it is also possible to order issues manually,
In group and project issue lists, it is also possible to order issues manually,
...
@@ -18,19 +29,25 @@ similar to [issue boards](../issue_board.md#how-gitlab-orders-issues-in-a-list).
...
@@ -18,19 +29,25 @@ similar to [issue boards](../issue_board.md#how-gitlab-orders-issues-in-a-list).
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62178) in GitLab 12.2.
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62178) in GitLab 12.2.
When you select **Manual** sorting, you can change
When you select **Manual** sorting, you can change
the order by dragging and dropping the issues. The changed order will persist. Everyone who visits the same list will see the reordered list, with some exceptions.
the order by dragging and dropping the issues. The changed order persists, and
everyone who visits the same list sees the updated issue order, with some exceptions.
Each issue is assigned a relative order value, representing its relative
Each issue is assigned a relative order value, representing its relative
order with respect to the other issues in the list. When you drag-and-drop reorder
order with respect to the other issues on the list. When you drag-and-drop reorder
an issue, its relative order value changes accordingly.
an issue, its relative order value changes.
In addition, any time that issue appears in a manually sorted list,
In addition, any time an issue appears in a manually sorted list,
the updated relative order value will be used for the ordering. This means that
the updated relative order value is used for the ordering.
if issue `A` is drag-and-drop reordered to be above issue `B` by any user in
So, if anyone drags issue `A` above issue `B` in your GitLab instance,
a given list inside your GitLab instance, any time those two issues are subsequently
this ordering is maintained whenever they appear together in any list.
loaded in any list in the same instance (could be a different project issue list or a
different group issue list, for example), that ordering will be maintained.
This ordering also affects [issue boards](../issue_board.md#how-gitlab-orders-issues-in-a-list).
This ordering also affects [issue boards](../issue_board.md#how-gitlab-orders-issues-in-a-list).
Changing the order in an issue list changes the ordering in an issue board,
Changing the order in an issue list changes the ordering in an issue board,
and vice versa.
and vice versa.
## Sorting by blocking issues
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34247/) in GitLab 13.7.
When you select to sort by **Blocking**, the issue list changes to sort descending by the
number of issues each issue is blocking. You can use this to determine the critical path for your backlog.
