Skip to main content

This version of GitHub Enterprise Server was discontinued on 2024-09-24. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Classifying your repository with topics

To help other people find and contribute to your project, you can add topics to your repository related to your project's intended purpose, subject area, affinity groups, or other important qualities.

About topics

With topics, you can explore repositories in a particular subject area, find projects to contribute to, and discover new solutions to a specific problem. Topics appear on the main page of a repository. You can click a topic name to search for other repositories with that topic.

Screenshot of the github/docs repository. In the right sidebar, three topics are outlined in dark orange: "docs," "hacktoberfest," and "works-with-codespaces."

To browse the most used topics, go to http(s)://HOSTNAME/topics/.

Repository admins can add any topics they'd like to a repository. Helpful topics to classify a repository include the repository's intended purpose, subject area, community, or language.

Public, private, and internal repositories can have topics, although you will only see private repositories that you have access to in topic search results.

You can search for repositories that are associated with a particular topic. For more information, see "Searching for repositories." You can also search for a list of topics on GitHub Enterprise Server. For more information, see "Searching topics."

When creating a topic:

  • Use lowercase letters, numbers, and hyphens.
  • Use 50 characters or less.
  • Add no more than 20 topics.

Adding topics to your repository

Note: Topic names are always public, even if you create the topic from within a private repository.

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

  2. In the top right corner of the page, to the right of "About", click .

    Screenshot of the top right of the main page for a repository. The "Edit repository metadata" button, shown as a gear icon, is outlined in orange.

  3. Under "Topics", start to type the topic you want to add to your repository to display a dropdown menu of any matching topics. Click the topic you want to add or continue typing to create a new topic.

    Screenshot of the "Topics" field showing example topics: "docs" and "works-with-codespaces." A "Suggested" topic "documentation" is shown below.

  4. Optional, if there are "Suggested" topics displayed under the "Topics" field, click to add or to decline the suggested topic.

  5. After you've finished adding topics, click Save changes.