Comment templates

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

• Feature flag saved_replies enabled on GitLab.com and GitLab Self-Managed in GitLab 16.0.
• Generally available in GitLab 16.6. Feature flag saved_replies removed.
• Saved replies for groups:
  • Introduced in GitLab 16.11 with a flag named group_saved_replies_flag. Disabled by default.
  • Generally available in GitLab 17.8. Feature flag group_saved_replies_flag removed.
• Saved replies for projects:
  • Introduced in GitLab 17.0 with a flag named project_saved_replies_flag. Enabled by default.
  • Generally available in GitLab 17.8. Feature flag project_saved_replies_flag removed.

{{< /history >}}

With comment templates, create and reuse text for any text area in:

• Merge requests, including diffs.
• Issues, including design management comments.
• Epics.
• Work items.

Comment templates can be small, like approving a merge request and unassigning yourself from it, or large, like chunks of boilerplate text you use frequently:

Use comment templates in a text area

To include the text of a comment template in your comment:

1. In the editor toolbar for your comment, select Comment templates ({{< icon name="comment-lines" >}}).
2. Select your desired comment template.

Create comment templates

You can create comment templates for your own use, or to share with all members of a group.

To create a comment template for your own use:

1. In the upper-right corner, select your avatar.
2. From the dropdown list, select Preferences.
3. In the left sidebar, select Comment templates ({{< icon name="comment-lines" >}}).
4. Select Add new.
5. Provide a Name for your comment template.
6. Enter the Content of your reply. You can use any formatting you use in other GitLab text areas.
7. Select Save, and the page reloads with your comment template shown.

For a group

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

To create a comment template shared with all members of a group:

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}), then select Manage group comment templates.
2. Select Add new.
3. Provide a Name for your comment template.
4. Enter the Content of your reply. You can use any formatting you use in other GitLab text areas.
5. Select Save, and the page reloads with your comment template shown.

For a project

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

To create a comment template shared with all members of a project:

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}), then select Manage project comment templates.
2. Select Add new.
3. Provide a Name for your comment template.
4. Enter the Content of your reply. You can use any formatting you use in other GitLab text areas.
5. Select Save, and the page reloads with your comment template shown.

View comment templates

To see existing comment templates:

1. In the upper-right corner, select your avatar.
2. From the dropdown list, select Preferences.
3. In the left sidebar, select Comment templates ({{< icon name="comment-lines" >}}).
4. Scroll to Comment templates.

For a group

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}).
2. Select Manage group comment templates.

For a project

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}).
2. Select Manage project comment templates.

Edit or delete comment templates

To edit or delete an existing comment template:

1. In the upper-right corner, select your avatar.
2. From the dropdown list, select Preferences.
3. In the left sidebar, select Comment templates ({{< icon name="comment-lines" >}}).
4. Scroll to Comment templates, and identify the comment template you want to edit.
5. To edit, select Edit ({{< icon name="pencil" >}}).
6. To delete, select Delete ({{< icon name="remove" >}}), then select Delete again on the dialog.

For a group

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}), then select Manage group comment templates.
2. To edit, select Edit ({{< icon name="pencil" >}}).
3. To delete, select Delete ({{< icon name="remove" >}}), then select Delete again on the dialog.

For a project

{{< details >}}

• Tier: Premium, Ultimate

{{< /details >}}

1. In the editor toolbar for a comment, select Comment templates ({{< icon name="comment-lines" >}}), then select Manage project comment templates.
2. To edit, select Edit ({{< icon name="pencil" >}}).
3. To delete, select Delete ({{< icon name="remove" >}}), then select Delete again on the dialog.