Managing default labels for repositories in your organization

You can customize the labels that are included in every new repository in your organization.

Organization owners can manage default labels for repositories in the organization.

Default labels are included in every new repository in your organization, but anyone with write access to the repository can edit or delete the labels in that repository later. Adding, editing, or deleting a default label does not add, edit, or delete the label from existing repositories.

Creating a default label

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  3. In the left sidebar, click Repository defaults. Repository defaults tab

  4. Under "Repository labels", click New label. New label button

  5. Under "Label name", type a name for your label. Field to type a label name

  6. Under "Description", type a description to help others understand and use your label. Field to type a label description

  7. Optionally, to customize the color of your label, edit the hexadecimal number, or click the refresh button for another random selection. Issues new label color refresh

  8. To save the new label, click Create label.

Editing a default label

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  3. In the left sidebar, click Repository defaults. Repository defaults tab

  4. In the labels list, to the right of the label you want to edit, click Edit.

  5. Under "Label name", type a name for your label. Field to type a label name

  6. Under "Description", type a description to help others understand and use your label. Field to type a label description

  7. Optionally, to customize the color of your label, edit the hexadecimal number, or click the refresh button for another random selection. Issues new label color refresh

  8. Click Save changes.

Deleting a default label

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  3. In the left sidebar, click Repository defaults. Repository defaults tab

  4. In the labels list, to the right of the label you want to delete, click Delete.

  5. Read the warning, then click OK.

Further reading

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.