Skip to content

Latest commit

 

History

History
68 lines (54 loc) · 3.68 KB

manually-creating-a-single-issue-template-for-your-repository.md

File metadata and controls

68 lines (54 loc) · 3.68 KB
title intro redirect_from versions topics shortTitle
Manually creating a single issue template for your repository
When you add a manually-created issue template to your repository, project contributors will automatically see the template's contents in the issue body.
/articles/creating-an-issue-template-for-your-repository
/articles/manually-creating-a-single-issue-template-for-your-repository
/github/building-a-strong-community/manually-creating-a-single-issue-template-for-your-repository
fpt ghes ghec
*
*
*
Community
Create an issue template

{% data reusables.repositories.legacy-issue-template-tip %}

You can create an ISSUE_TEMPLATE/ subdirectory in any of the supported folders to contain multiple issue templates, and use the template query parameter to specify the template that will fill the issue body. For more information, see AUTOTITLE.

You can add YAML frontmatter to each issue template to pre-fill the issue title, automatically add labels and assignees, and give the template a name and description that will be shown in the template chooser that people see when creating a new issue in your repository.

Here is example YAML front matter.

---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat
---

Note

If a front matter value includes a YAML-reserved character such as : , you must put the whole value in quotes. For example, ":bug: Bug" or ":new: triage needed, :bug: bug".

{% ifversion fpt or ghec %}

{% data reusables.repositories.valid-community-issues %}

{% endif %}

{% data reusables.repositories.default-issue-templates %}

Adding an issue template

{% data reusables.repositories.navigate-to-repo %} {% data reusables.files.add-file %}

  1. In the file name field:
    • To make your issue template visible in the repository's root directory, type the name of your issue_template. For example, issue_template.md.
    • To make your issue template visible in the repository's docs directory, type docs/ followed by the name of your issue_template. For example, docs/issue_template.md,
    • To store your file in a hidden directory, type .github/ followed by the name of your issue_template. For example, .github/issue_template.md.
    • To create multiple issue templates and use the template query parameter to specify a template to fill the issue body, type .github/ISSUE_TEMPLATE/, then the name of your issue template. For example, .github/ISSUE_TEMPLATE/issue_template.md. You can also store multiple issue templates in an ISSUE_TEMPLATE subdirectory within the root or docs/ directories. For more information, see AUTOTITLE.
  2. In the body of the new file, add your issue template. This could include:
    • YAML frontmatter
    • Expected behavior and actual behavior
    • Steps to reproduce the problem
    • Specifications like the version of the project, operating system, or hardware {% data reusables.files.write_commit_message %} {% data reusables.files.choose_commit_branch %} Templates are available to collaborators when they are merged into the repository's default branch. {% data reusables.files.propose_new_file %}

Further reading