Skip to main content

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 see related topics and a list of other repositories classified 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 https://github.com/topics/.

You can contribute to GitHub's set of featured topics in the github/explore repository.

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. Additionally, GitHub analyzes public repository content and generates suggested topics that repository admins can accept or reject. Private repository content is not analyzed and does not receive topic suggestions.

Public and private 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. 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.