Managing notifications from your inbox
Use your inbox to quickly triage and sync your notifications across email and mobile.
To use the notifications inbox on GitHub and GitHub for mobile, you must enable web and mobile notifications in your notification settings. For more information, see "Configuring notifications."
To access your notifications inbox, in the upper-right corner of any page, click .
Your inbox shows all of the notifications that you haven't unsubscribed to or marked as Done. You can customize your inbox to best suit your workflow using filters, viewing all or just unread notifications, and grouping your notifications to get a quick overview.
By default, your inbox will show read and unread notifications. To only see unread notifications, click Unread or use the
You have several options for triaging notifications from your inbox.
|Save||Saves your notification for later review. To save a notification, to the right of the notification, click . |
Saved notifications are kept indefinitely and can be viewed by clicking Saved in the sidebar or with the
|Done||Marks a notification as completed and removes the notification from your inbox. You can see all completed notifications by clicking Done in the sidebar or with the |
|Unsubscribe||Automatically removes the notification from your inbox and unsubscribes you from the conversation until you are @mentioned, a team you're on is @mentioned, or you're requested for review.|
|Read||Marks a notification as read. To only view read notifications in your inbox, use the |
|Unread||Marks notification as unread. To only view unread notifications in your inbox, use the |
To see the available keyboard shortcuts, see "Keyboard Shortcuts."
Before choosing a triage option, you can preview your notification's details first and investigate. For more information, see "Triaging a single notification."
To triage multiple notifications at once, select the relevant notifications and use the drop-down to choose a triage option.
By default, your inbox has filters for when you are assigned, participating in a thread, requested to review a pull request, or when your username is @mentioned directly or a team you're a member of is @mentioned.
You can add up to 15 of your own custom filters.
In the upper-right corner of any page, click .
To open the filter settings, in the left sidebar, next to "Filters", click .
Tip: You can quickly preview a filter's inbox results by creating a query in your inbox view and clicking Save, which opens the custom filter settings.
Add a name for your filter and a filter query. For example, to only see notifications for a specific repository, you can create a filter using the query
repo:octocat/open-source-project-name reason:participating. You can also add emojis with a native emoji keyboard. For a list of supported search queries, see "Supported queries for custom filters."
Custom filters do not currently support:
- Full text search in your inbox, including searching for pull request or issue titles.
- Distinguishing between the
is:pull-requestquery filters. These queries will return both issues and pull requests.
- Creating more than 15 custom filters.
- Changing the default filters or their order.
There are three types of filters that you can use:
- Filter by repository with
- Filter by discussion type with
- Filter by notification reason with
To add a
repo: filter, you must include the owner of the repository in the query. For example,
repo:atom/atom represents the Atom repository owned by the Atom organization.
To filter notifications by why you've received an update, you can use the
reason: query. For example, to see notifications when you (or a team you're on) is requested to review a pull request, use
reason:review-requested. For more information, see "About notifications."
|When there's an update on an issue or pull request you've been assigned to.|
|When you opened a pull request or issue and there has been an update or new comment.|
|When you commented on an issue, pull request, or team discussion.|
|When you have commented on an issue, pull request, or team discussion or you have been @mentioned.|
|When you're invited to a team, organization, or repository.|
|When you click Subscribe on an issue or pull request you weren't already subscribed to.|
|You were directly @mentioned.|
|You or a team you're on have been requested to review a pull request.|
|When a security alert is issued for a repository.|
|When the state of a pull request or issue is changed. For example, an issue is closed or a pull request is merged.|
|When a team you're a member of is @mentioned.|
|When a repository has a CI update, such as a new workflow run status.|
To filter notifications for specific activity on GitHub, you can use the
is query. For example, to only see repository invitation updates, use
You can also use the
is: query to describe how the notification was triaged.