GitHub Help

Considerations for code search

Due to the complexity of searching code, there are a few restrictions on how searches are performed:

• Only the default branch is considered. In most cases, this will be the master branch.
• Only files smaller than 200 KB are searchable.
• You must always include at least one search term when searching source code. For example, searching for language:go is not valid, while amazing language:go is.

Scope the search fields

The in qualifier limits what fields are searched. With this qualifier, you can restrict your search to the source code, the file path, or both. Without the qualifier, only the file contents are searched.

octocat in:file

Matches code where "octocat" appears in the file contents.

octocat in:path

Matches code where "octocat" appears in the path name.

octocat in:file,path

Matches code where "octocat" appears in the file contents or the path name.

display language:scss

Matches code with the word "display," that's marked as being SCSS.

Integer

Matches code with the word "Integer".

Search by language

You can search for code based on what language it's written in. For example:

element language:xml size:100

Matches code with the word "element" that's marked as being XML and has exactly 100 bytes.

user:mozilla language:markdown

Matches code from all @mozilla's repositories that's marked as Markdown.

Search by the number of forks the parent repository has

Much like with repositories, you can opt to search code files that exist within forked repositories. However, to ensure better relevancy, repository forks will not be searchable unless the fork has more stars than the parent repository.

If you would like forked results to appear, add the fork:true qualifier. For example:

android language:java fork:true

Matches code in a forked repository with the word "android" that's written in Java.

Search by the size of the parent repository

The size qualifier filters results based on the size of the file in which the code is found. For example:

function size:>10000 language:python

Matches code with the word "function," written in Python, in files that are larger than 10 KB.

Search by the location of a file within the repository

By including the path qualifier, you specify that resulting source code must appear at a specific location in a repository. Subfolders are considered during the search, so be as specific as possible. For example:

console path:app/public language:javascript

Finds JavaScript files with the word "console" in an app/public directory (even if they reside in app/public/js/form-validators).

form path:cgi-bin language:perl

Finds Perl files under cgi-bin with the word "form" in them.

Search by filename

You can use the filename qualifier if there's a specific file you're looking for. For example:

filename:.vimrc commands

Finds *.vimrc* files with the word "commands" in them.

minitest filename:test_helper path:test language:ruby

Finds Ruby files containing the word "minitest" named *test_helper* within the *test* directory.

Search by the file extension

The extension qualifier matches code files with a certain extension. For example:

form path:cgi-bin extension:pm

Matches code with the word "form," under cgi-bin, with the .pm extension.

icon size:>200000 extension:css

Finds files larger than 200 KB that end in .css and have the word "icon" in them.

Search within a user's or organization's repositories

To grab a list of code from all repositories owned by a certain user or organization, you can use the user syntax. For getting a list of code from a specific repository, you can use the repo syntax. For example:

user:github extension:rb

Matches code from GitHub that ends in .rb.

repo:mozilla/shumway extension:as

Matches code from @mozilla's shumway project that ends in .as.

Sort the results

With any of the qualifiers above, you can also choose to sort on when the code was last indexed. This can be in ascending or descending order.