System notes
System notes are short descriptions that help you understand the history of events that occur during the life cycle of a GitLab object, such as:
- Alerts.
- Designs.
- Issues.
- Merge requests.
- Objectives and key results (OKRs).
- Tasks.
GitLab logs information about events triggered by Git or the GitLab application
in system notes. System notes use the format <Author> <action> <time ago>
.
Show or filter system notes
By default, system notes do not display. When displayed, they are shown oldest first. If you change the filter or sort options, your selection is remembered across sections. The filtering options are:
- Show all activity displays both comments and history.
- Show comments only hides system notes.
- Show history only hides user comments.
On an epic
- On the left sidebar, select Search or go to and find your project.
- Select Plan > Epics.
- Identify your desired epic, and select its title.
- Go to the Activity section.
- For Sort or filter, select Show all activity.
On an issue
- On the left sidebar, select Search or go to and find your project.
- Select Plan > Issues and find your issue.
- Go to Activity.
- For Sort or filter, select Show all activity.
On a merge request
- On the left sidebar, select Search or go to and find your project.
- Select Code > Merge requests and find your merge request.
- Go to Activity.
- For Sort or filter, select Show all activity.
Privacy considerations
You can see only the system notes linked to objects you can access.
For example, if someone mentions your issue 111 in an issue in their private project:
- The project members see the following note in issue 111:
Alex Garcia mentioned in agarcia/private-project#222
. - Non-members of the project can’t see the note at all.