Article version: GitHub.com

Adding support resources to your project

You can create a SUPPORT file to let people know about ways to get help with your project.

To direct people to specific support resources, you can add a SUPPORT file to your repository's root, docs, or .github folder. When someone creates an issue in your repository, they will see a link to your project's SUPPORT file.

Support guidelines

You can create default support resources for your organization. For more information, see "Creating a default community health file for your organization."

Tip: To help people find your support guidelines, you can link to your SUPPORT file from other places in your repository, such as your README file.

Adding support resources to your project

  1. On GitHub, navigate to the main page of the repository.

  2. Above the file list, click Create new file.

    The New file button

  3. In the file name field, type SUPPORT.md (with all caps).

  4. On the Edit new file tab, add information about how people can get support for your project.

  5. To review your SUPPORT file, click Preview.

  6. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

    Commit message for your change

  7. Below the commit message fields, click the email address drop-down menu and choose a Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then <username>@users.noreply.github.com is the default commit author email address. For more information, see "Setting your commit email address."

    Choose commit email addresses

  8. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

    Commit branch options

  9. Click Propose new file.

    Propose new file button

Ask a human

Can't find what you're looking for?

Contact us