Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
d460143f
Commit
d460143f
authored
Oct 25, 2021
by
Marcin Sedlak-Jakubowski
Committed by
Fiona Neill
Oct 25, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Enhance sorting issue lists doc
parent
496719fd
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
82 additions
and
23 deletions
+82
-23
doc/user/project/issues/sorting_issue_lists.md
doc/user/project/issues/sorting_issue_lists.md
+82
-23
No files found.
doc/user/project/issues/sorting_issue_lists.md
View file @
d460143f
...
...
@@ -8,34 +8,59 @@ info: To determine the technical writer assigned to the Stage/Group associated w
You can sort a list of issues several ways, including by:
-
Blocking
**(PREMIUM)**
-
Created date
-
Due date
-
Label priority
-
Last updated
-
Milestone due date
-
Popularity
-
Priority
-
Title (
[
introduced
](
https://gitlab.com/gitlab-org/gitlab/-/merge_requests/67234
)
in GitLab 14.3)
-
Weight
-
[
Blocking issues
](
#sorting-by-blocking-issues
)
-
[
Created date
](
#sorting-by-created-date
)
-
[
Due date
](
#sorting-by-due-date
)
-
[
Label priority
](
#sorting-by-label-priority
)
-
[
Last updated
](
#sorting-by-last-updated
)
-
[
Manual sorting
](
#manual-sorting
)
-
[
Milestone due date
](
#sorting-by-milestone-due-date
)
-
[
Popularity
](
#sorting-by-popularity
)
-
[
Priority
](
#sorting-by-priority
)
-
[
Title
](
#sorting-by-title
)
-
[
Weight
](
#sorting-by-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
)
.
In group and project issue lists, it is also possible to order issues manually,
similar to
[
issue boards
](
../issue_board.md#ordering-issues-in-a-list
)
.
## Sorting by blocking issues **(PREMIUM)**
## Sorting by popularity
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34247/) in GitLab 13.7.
When you select sorting by
**Popularity**
, the issue order changes to sort descending by the
number of upvotes (
[
awarded
](
../../award_emojis.md
)
"thumbs up" emoji)
on each issue. You can use this to identify issues that are in high demand.
When you sort by
**Blocking**
, the issue list changes to sort descending by the
number of issues each issue is blocking.
## Sorting by created date
When you sort by
**Created date**
, the issue list changes to sort descending by the issue
creation date. Issues created most recently are first.
## Sorting by due date
When you sort by
**Due date**
, the issue list changes to sort ascending by the issue
[
due date
](
issue_data_and_actions.md#due-date
)
. Issues with the earliest due date are first,
and issues without a due date are last.
## Sorting by label priority
When you sort by
**Label priority**
, the issue list changes to sort descending.
Issues with the highest priority label are first, then all other issues.
Ties are broken arbitrarily. Only the highest prioritized label is checked,
and labels with a lower priority are ignored.
For more information, see
[
issue 14523
](
https://gitlab.com/gitlab-org/gitlab/-/issues/14523
)
.
To learn more about priority labels, read the
[
Labels
](
../labels.md#label-priority
)
documentation.
## Sorting by last updated
When you sort by
**Last updated**
, the issue list changes to sort by the time of a last
update. Issues changed the most recently are first.
## Manual sorting
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62178) in GitLab 12.2.
When you s
elect
**Manual**
sorting
, you can change
When you s
ort by
**Manual**
order
, you can change
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.
...
...
@@ -50,11 +75,45 @@ this ordering is maintained whenever they appear together in any list.
This ordering also affects
[
issue boards
](
../issue_board.md#ordering-issues-in-a-list
)
.
Changing the order in an issue list changes the ordering in an issue board,
and
vice versa
.
and
the other way around
.
## Sorting by
blocking issues **(PREMIUM)**
## Sorting by
milestone due date
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/34247/) in GitLab 13.7.
When you sort by
**Milestone due date**
, the issue list changes to sort ascending by the
assigned milestone due date. Issues with milestones with the earliest due date are first,
then issues with a milestone without a due date.
## Sorting by popularity
When you sort by
**Popularity**
, the issue order changes to sort descending by the
number of upvotes (
[
awarded
](
../../award_emojis.md
)
a "thumbs up" emoji)
on each issue. You can use this to identify issues that are in high demand.
## Sorting by priority
When you sort by
**Priority**
, the issue order changes to sort in this order:
1.
Issues with milestones that have due dates, where the soonest assigned milestone is listed first.
1.
Issues with milestones with no due dates.
1.
Issues with a higher priority label.
1.
Issues without a prioritized label.
To learn more about priority, read the
[
Labels
](
../labels.md#label-priority
)
documentation.
## Sorting by title
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/67234) in GitLab 14.3.
When you sort by
**Title**
, the issue order changes to sort alphabetically by the issue
title in this order:
-
Emoji
-
Special characters
-
Numbers
-
Letters: first Latin, then accented (for example,
`ö`
)
## Sorting by weight
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.
When you sort by
**Weight**
, the issue list changes to sort ascending by the
[
issue weight
](
issue_weight.md
)
.
Issues with lowest weight are first, and issues without a weight are last.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment