| title | Searching commits | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| intro | You can search for commits on {% data variables.product.product_name %} and narrow the results using these commit search qualifiers in any combination. | ||||||||
| redirect_from |
|
||||||||
| versions |
|
||||||||
| topics |
|
You can search for commits globally across all of {% data variables.product.product_name %}, or search for commits within a particular repository or organization. For more information, see "About searching on {% data variables.product.company_short %}."
When you search for commits, only the default branch of a repository is searched.
{% data reusables.search.syntax_tips %}
You can find commits that contain particular words in the message. For example, fix typo matches commits containing the words "fix" and "typo."
You can find commits by a particular user with the author or committer qualifiers.
| Qualifier | Example |
|---|---|
author:USERNAME |
author:defunkt matches commits authored by @defunkt. |
committer:USERNAME |
committer:defunkt matches commits committed by @defunkt. |
The author-name and committer-name qualifiers match commits by the name of the author or committer.
| Qualifier | Example |
|---|---|
author-name:NAME |
author-name:wanstrath matches commits with "wanstrath" in the author name. |
committer-name:NAME |
committer-name:wanstrath matches commits with "wanstrath" in the committer name. |
The author-email and committer-email qualifiers match commits by the author's or committer's full email address.
| Qualifier | Example |
|---|---|
author-email:EMAIL |
author-email:chris@github.com matches commits authored by chris@github.com. |
committer-email:EMAIL |
committer-email:chris@github.com matches commits committed by chris@github.com. |
Use the author-date and committer-date qualifiers to match commits authored or committed within the specified date range.
{% data reusables.search.date_gt_lt %}
| Qualifier | Example |
|---|---|
author-date:YYYY-MM-DD |
author-date:<2016-01-01 matches commits authored before 2016-01-01. |
committer-date:YYYY-MM-DD |
committer-date:>2016-01-01 matches commits committed after 2016-01-01. |
The merge qualifier filters merge commits.
| Qualifier | Example |
|---|---|
merge:true |
merge:true matches merge commits. |
merge:false |
merge:false matches non-merge commits. |
The hash qualifier matches commits with the specified SHA-1 hash.
| Qualifier | Example |
|---|---|
hash:HASH |
hash:124a9a0ee1d8f1e15e833aff432fbb3b02632105 matches commits with the hash 124a9a0ee1d8f1e15e833aff432fbb3b02632105. |
The parent qualifier matches commits whose parent has the specified SHA-1 hash.
| Qualifier | Example |
|---|---|
parent:HASH |
parent:124a9a0ee1d8f1e15e833aff432fbb3b02632105 matches children of commits with the hash 124a9a0ee1d8f1e15e833aff432fbb3b02632105. |
The tree qualifier matches commits with the specified SHA-1 git tree hash.
| Qualifier | Example |
|---|---|
tree:HASH |
tree:99ca967 matches commits that refer to the tree hash 99ca967. |
To search commits in all repositories owned by a certain user or organization, use the user or org qualifier. To search commits in a specific repository, use the repo qualifier.
| Qualifier | Example |
|---|---|
user:USERNAME |
gibberish user:defunkt matches commit messages with the word "gibberish" in repositories owned by @defunkt. |
org:ORGNAME |
test org:github matches commit messages with the word "test" in repositories owned by @github. |
repo:USERNAME/REPO |
language repo:defunkt/gibberish matches commit messages with the word "language" in @defunkt's "gibberish" repository. |
The is qualifier matches commits from repositories with the specified visibility. For more information, see "About repositories."
| Qualifier | Example
| ------------- | ------------- |{% ifversion fpt or ghes or ghec %}
| is:public | is:public matches commits to public repositories.{% endif %}{% if internal-repositories %}
| is:internal | is:internal matches commits to internal repositories.{% endif %}
| is:private | is:private matches commits to private repositories.