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.

In this article

You can search, sort, and filter your starred repositories and topics on yourstars 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 yourstars 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 GitHubshows 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, clickStar.
    Screenshot of the repository bar with the "Star" option highlighted with a dark orange outline.
  3. Optionally, to unstar a previously starred repository, clickStarred.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/stargazersto the end of the URL of a repository. For example, to view stargazers for the github/docs repository, visithttps://github /github/docs/stargazers.

Organizing starred repositories with lists

Note:Lists are currently in public beta and subject to change.

Curate repositories that you've starred with public lists. You can create public lists that appear on your stars page athttps://github /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 withreadaccess to the repository.

You can add a repository to an existing or new list wherever you see a repository'sStarorStarreddropdown 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 clickYour stars.

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

  2. Next to "Lists", clickCreate list.

  3. Enter a name and description for your list and clickCreate.

Adding a repository to a list

  1. In the upper-right corner of any page, click your profile photo, then clickYour 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 theStarreddropdown 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 clickYour 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 theStarreddrop-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 clickYour 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. ClickEdit list.

  4. Update the name or description and clickSave list.

Deleting a list

  1. In the upper-right corner of any page, click your profile photo, then clickYour 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. ClickDelete list.

  4. To confirm, clickDelete.

Searching starred repositories and topics

You can use the search bar on yourstars pageto quickly find repositories and topics you've starred.

  1. In the upper-right corner of any page, click your profile photo, then clickYour 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 clickYour stars.

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

  2. To sort stars, select theSort by:dropdown menu, then selectRecently starred,Recently active,orMost stars.

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

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

Further reading