Creating a default community health file for your organization

You can create default community health files, such as CONTRIBUTING and CODE_OF_CONDUCT, for your organization. Default files will be used for any public repository in your organization that does not contain its own file of that type.

In this guide

About default community health files

You can add default community health files for your organization to the root of a public repository called .github that is owned by the organization.

GitHub will use and display default files for any public repository in the organization that does not have its own file of that type in any of the following places:

For example, anyone who creates an issue or pull request in a public repository that does not have its own CONTRIBUTING file will see a link to the default CONTRIBUTING file.

Default files are not included in clones, packages, or downloads of individual repositories because they are stored only in the .github repository.

Supported file types

You can create organization-wide defaults for the following community health files:

Community health file Description
CODE_OF_CONDUCT A CODE_OF_CONDUCT file defines standards for how to engage in a community. For more information, see "Adding a code of conduct to your project."
CONTRIBUTING A CONTRIBUTING file communicates how people should contribute to your project. For more information, see "Setting guidelines for repository contributors."
Issue and pull request templates Issue and pull request templates customize and standardize the information you'd like contributors to include when they open issues and pull requests in your repository. For more information, see "About issue and pull request templates."
SUPPORT A SUPPORT file lets people know about ways to get help with your project. For more information, see "Adding support resources to your project."

You cannot create a default license file for your organization. License files must be added to individual repositories so the file will be included when a project is cloned, packaged, or downloaded.

Creating a repository for default files

  1. In the upper-right corner of any page, click , and then click New repository.

    Drop-down with option to create a new repository

  2. Use the Owner drop-down menu, and select the organization you want to create default files for.

    Owner drop-down menu

  3. Type .github as the name for your repository, and an optional description.

    Create repository field

  4. Choose to make the repository public.

    Radio buttons to select private or public status

  5. Select Initialize this repository with a README.

    Initialize this repository with a README checkbox

  6. Click Create repository.

  7. In the root of the repository, create one of the supported community health files. For more information, see "Creating new files."

Ask a human

Can't find what you're looking for?

Contact us