GitHub is a popular code collaboration platform for developers. You can use it to share, manage, and contribute to open-source codebases, save and work on your own code, and more.
And to be a more effective GitHub user, you'll need to know how to search within the platform.
This involves using qualifiers to efficiently filter through millions of repositories and billions of lines of code. Precise queries help you locate specific function definitions, projects, people, issues, pull requests, code, security vulnerabilities, or contribution opportunities.
In this tutorial, you'll learn how to use GitHub search, whether you're a beginner or a pro developer.
To enhance your learning, I've divided this article into two sections:
Basic Search Functionality
Advanced Search Functionality
What We'll Cover:
Basic Search Functionality
Basic search here refers to the most commonly used search functionalities that are fast and easy to use.
To start, click the GitHub search icon, type your query, and GitHub will display your results. With basic search, you can search globally across all of GitHub or narrow your search to a specific repository or organization.
How to Search Globally
To search on GitHub, click the search tab or press the / key to open the search bar.
To search globally (across all of GitHub), open the search input, type your query, and select "Search all of GitHub" from the dropdown menu or press enter.
After clicking the "Search all of GitHub" button, you'll be directed to a page displaying all results related to your query.
How to Do a Scoped Search (for a Particular Repo or Organization)
To search within a specific repository or organization, go to the repository or organization page, enter your query in the search field at the top, and press Enter.
For instance, if you're searching for a file name starting with "pnpm" in the frontendweb repository:
In the search bar, you'll see four suggestions: the first is "Search in this repository," the second is "Search in this organization," the third is "Search all of GitHub," and the last is the code section "Display similar files." Clicking a file opens it in the GitHub web editor.
Advanced Search Functionality
In addition to the GitHub search bar, you can search on GitHub using the advanced search page.
GitHub's advanced search allows you to find specific code, repositories, and issues. You can filter your searches by factors such as the number of stars, owners, forks, followers, programming language, and creation dates.
As you complete the advanced search fields, your query is automatically generated in the top search bar, and you can click on the Search button.
For a basic example, let's search for React on GitHub, including recent pull and push requests, issues, commits, discussions, and so on, related to ReactJS. We can use GitHub's advanced search functionality for this. Type "React" in the first input field as text and add the owner, in this case, Facebook, to find everything related to ReactJS in the Facebook organization or user.
After clicking on the Search button, you should see the following results page:
As you can see, GitHub's advanced search functionality lets you find specific code, repositories and issues using a powerful set of qualifiers and options. Let's talk more about qualifiers now.
Search Qualifiers
You can filter your search directly using various key qualifiers. We can divide these qualifiers into different sections:
Advanced Options
From these owners: type the specific user's or organization's name, such as GitHub, Atom, Electron, Octokit, and so on.
In these repositories: type the specific user's or organization's name, such as Facebook/React, Vercel/Next.js, and so on.
Created on these dates: Specify the repository creation date, for example
>2016-04-29,=2016-04-29, etc., to learn more, check out the Query for dates documentation.Written in this language: Select the specific language that matches repositories from lists: JavaScript, TypeScript, Rust, and so on, or what it’s written in.
Repository Options
With this many stars: Type the number of stars in the
stars:field to filter and find repositories by star count. You can apply comparisons like >1000 (more than 1000 stars) or =1000 (exactly 1000 stars) to narrow results based on popularity.With this many forks: Type the number of forks to filter and find repositories by fork count. You can apply comparisons like 100..1000 (find repos with 100 to 1000 forks), >1000 (more than 1000 forks), or =1000 (exactly 1000 forks) to narrow results based on popularity.
Of this size: type the repository size in KB to filter and find repositories, for example, size of 10000 KB
Pushed to: type the date to filter and find repositories, for example >2013-02-01 matches repositories with the word "react" that were pushed to after January 2013.
With this license: Select the license to filter or find repositories based on license, for example, those licensed under the Apache License 2.0.
Code Options
With this extension: type the extension, such as rb, py, or jpg, that you want to search on GitHub.
In this path: Type the path to filter on GitHub to search for files by their location within a repository. For example, you can find a header.tsx file specifically inside the
./componentsfolder by combining filename: with path:.With this file name: Type the file name, such as app, footer, or header, that you want to search on GitHub.
Issue Options
In the state: Select the issue state (whether the issue is open or closed), for example, libraries
state:open mentions:rajdeepmatches open issues that mention @rajdeep with the word "libraries," orlanguage:JavaScript state:openmatches open issues in JavaScript repositories.With this many comments: Enter the comment number based on the comment count. You can filter the issue, for example,
state:closed comments:>100matches closed issues with more than 100 comments, orcomments:500..1000matches issues with comments ranging from 500 to 1,000.With the labels: Enter the label to filter or narrow your results by labels. Since issues can have multiple labels, you can list and add multiple label qualifiers for each issue.
For example, first,
label:bug label:resolvedmatches issues with the labels "bug" and "resolved." Second,label:bug,resolvedmatches issues with the label "bug" or the label "resolved." Third, examplebroken in:body -label:bug label:prioritymatches issues with the word "broken" in the body, that lack the label "bug," but do have the label "priority."Opened by the author: Enter the name or username to filter or find issues created by a user or integration account, or filter the issues based on the author.
For example,
author:rajdeepmatches issues with the word "fixed" that were created by @rajdeep, orauthor:octocatmatches issues created by the account named "octocat."Mentioning the users: Enter the name or username to find issues that mention the user. For example, fixed mentions:rajdeep matches issues with the word "fixed" that mention @rajdeep in the issue.
Assigned to the users: Enter the name or username to find or filter issues based on the specific username assigned to the issue. For example,
state:open assignee:rajdeepmatches open issues that are assigned to @rajdeep.Updated before the date: Enter the date, filter issues based on the time of creation, or when they were last updated.
For example
language:c# created:<2011-01-01 state:openmatches open issues that were created before 2011 in repositories written in C# orweird in:body updated:>=2013-02-01matches issues with the word "weird" in the body that were updated after February 2013.
User Options
With this full name: Enter a full name to filter repositories whose name includes “rajdeep singh” on GitHub.
From this location: Enter a location to find users on GitHub. For example,
location:russia language:javascriptreturns users based in Russia whose repositories are primarily written in JavaScript.With this many followers: Enter a follower count to filter users by popularity. For example,
followers:>=1000finds users with 1,000 or more followers, whilefollowers:1..10 rajdeepreturns users with 1–10 followers whose name includes “rajdeep” on GitHub.With this many public repositories: Enter a repository count to filter users by the number of public repositories they have. For example, repos:>10 finds users with more than 10 repositories, while repos:10..30 returns users who have between 10 and 30 public repositories on GitHub.
Working in this language: Select the language to find users based on the primary languages of their repositories. For example,
language:javascript location:russiareturns users in Russia whose repositories are mostly written in JavaScript, whilelanguage:javascript fullname:rajdeepfinds users with JavaScript repositories whose full name includes "rajdeep" on GitHub.
Wiki Options
- Updated before the date: Enter a date to filter wiki pages containing “next.js” that were last updated after
2016-01-01in your GitHub wiki.
The best way to use advanced search qualifiers is to combine one or multiple qualifier/search options to achieve the best result.
How to Save Searches
I don't often use GitHub Advanced Search, but I used it to find open-source projects to learn from and contribute to. If you take a moment to fill in the information in GitHub Advanced Search, you can save the search for future use:
Enter the name and click the "Create saved search" button:
You can show a list of all your saved searches:
How to Manage Saved Searches on GitHub
To manage a saved search, open the search bar and type "saved:" in the search bar, then click the "Manage saved searches" button.
To edit a saved search, click the pencil icon next to it. To delete a saved search, click the trash icon.
Why Do We Need GitHub Advanced Search?
As mentioned, GitHub Advanced Search helps you find the best issues to contribute to in open source repositories.
For example, I'm an expert in Next.js and React.js, and I can use GitHub Advanced Search to locate suitable issues in open-source projects for contribution.
Even as a beginner developer, you can use GitHub Advanced Search to find "good first issues" labeled by maintainers, making it easier to contribute.
Conclusion
GitHub Advanced Search is versatile. t's not just for searching but also for researching recent issues, pull requests, and push requests that may be related to your query, repository, user, or anything else. My favorite use is finding open-source contribution opportunities with GitHub Advanced Search.