forgejo/docs/content/doc/usage/merge-message-templates.en-us.md

date	title	slug	weight	toc	draft	aliases	menu
2022-08-31T17:35:40+08:00	Merge Message templates	merge-message-templates	15	false	false	/en-us/merge-message-templates	sidebar parent name weight identifier usage Merge Message templates 15 merge-message-templates

Merge Message templates

Table of Contents

{{< toc >}}

File names

Possible file names for PR default merge message templates:

• .gitea/default_merge_message/MERGE_TEMPLATE.md
• .gitea/default_merge_message/REBASE_TEMPLATE.md
• .gitea/default_merge_message/REBASE-MERGE_TEMPLATE.md
• .gitea/default_merge_message/SQUASH_TEMPLATE.md
• .gitea/default_merge_message/MANUALLY-MERGED_TEMPLATE.md
• .gitea/default_merge_message/REBASE-UPDATE-ONLY_TEMPLATE.md

Variables

You can use the following variables enclosed in ${} inside these templates which follow os.Expand syntax:

• BaseRepoOwnerName: Base repository owner name of this pull request
• BaseRepoName: Base repository name of this pull request
• BaseBranch: Base repository target branch name of this pull request
• HeadRepoOwnerName: Head repository owner name of this pull request
• HeadRepoName: Head repository name of this pull request
• HeadBranch: Head repository branch name of this pull request
• PullRequestTitle: Pull request's title
• PullRequestDescription: Pull request's description
• PullRequestPosterName: Pull request's poster name
• PullRequestIndex: Pull request's index number
• PullRequestReference: Pull request's reference char with index number. i.e. #1, !2
• ClosingIssues: return a string contains all issues which will be closed by this pull request i.e. close #1, close #2

Rebase

When rebasing without a merge commit, REBASE_TEMPLATE.md modifies the message of the last commit. The following additional variables are available in this template:

• CommitTitle: Commit's title
• CommitBody: Commits's body text