[go: up one dir, main page]

Skip to main content

Saving repositories with stars

You can star repositories and topics to keep track of projects you find interesting and discover related content in your news feed.

You can search, sort, and filter your starred repositories and topics on your stars page.

About stars

Starring makes it easy to find a repository or topic again later. You can see all the repositories and topics you have starred by going to your stars page.

You can star repositories and topics to discover similar projects on GitHub. When you star repositories or topics, GitHub may recommend related content on your personal dashboard. For more information, see "Finding ways to contribute to open source on GitHub" and "About your personal dashboard."

Starring a repository also shows appreciation to the repository maintainer for their work. Many of GitHub's repository rankings depend on the number of stars a repository has. In addition, Explore GitHub shows popular repositories based on the number of stars they have.

Starring a repository

Starring a repository is a simple two-step process.

  1. On GitHub, navigate to the main page of the repository.
  2. In the top-right corner of the page, click Star.
    Screenshot of the repository bar with the "Star" option highlighted with a dark orange outline.
  3. Optionally, to unstar a previously starred repository, click Starred. This will remove the repository from your starred list.
    Screenshot of the repository bar. The "Starred" button is highlighted with a dark orange outline.

Viewing who has starred a repository

You can view everyone who has starred a public repository or a private repository you have access to.

To view everyone who has starred a repository, add /stargazers to the end of the URL of a repository. For example, to view stargazers for the github/docs repository, visit https://github.com/github/docs/stargazers.

Organizing starred repositories with lists

Note

Lists are currently in public preview and subject to change.

Curate repositories that you've starred with public lists. You can create public lists that appear on your stars page at https://github.com/USERNAME?tab=stars.

Screenshot the "Stars" tab of Octocat's profile. Two named lists of stars are displayed.

If you add a private repository to a list, then the private repository will only appear in your list for people with read access to the repository.

You can add a repository to an existing or new list wherever you see a repository's Star or Starred dropdown menu, whether on a repository page or in a list of starred repositories.

Screenshot of a repository page. The "Star" dropdown menu is expanded, with a list options highlighted with a dark orange outline.

Creating a list

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Next to "Lists", click Create list.

  3. Enter a name and description for your list and click Create.

Adding a repository to a list

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Find the repository you want to add to your list by typing it into the search bar.

  3. Next to the repository you want to add, use the Starred dropdown menu and select your list.

    Screenshot of a list of repositories on the "Stars" page. Next to a repository, under the "Starred" button, a dropdown menu is outlined in orange.

Removing a repository from your list

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Select your list.

  3. Next to the repository you want to remove, use the Starred drop-down menu and deselect your list.

    Screenshot of a list of repositories on the "Stars" page. Next to a repository, under the "Starred" button, a dropdown menu is outlined in orange.

Editing a list name or description

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Select the list you want to edit.

  3. Click Edit list.

  4. Update the name or description and click Save list.

Deleting a list

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Select the list you want to delete.

  3. Click Delete list.

  4. To confirm, click Delete.

Searching starred repositories and topics

You can use the search bar on your stars page to quickly find repositories and topics you've starred.

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. Use the search bar to find your starred repositories or topics by their name.

The search bar only searches based on the name of a repository or topic, and not on any other qualifiers (such as the size of the repository or when it was last updated).

Sorting and filtering stars on your stars page

You can use sorting or filtering to customize how you see starred repositories and topics on your stars page.

  1. In the upper-right corner of any page, click your profile photo, then click Your stars.

    Screenshot of the profile menu for octocat. The "Your stars" option is highlighted with an orange outline.

  2. To sort stars, select the Sort by: dropdown menu, then select Recently starred, Recently active, or Most stars.

  3. To filter your list of stars based on their language, click on the desired language under the Language dropdown menu.

  4. To filter your list of stars based on repository type, click on the desired option under the Type: dropdown menu.

Further reading