Docs
Docs menu

Inbox and notifications

What waits on you, what happened to your work, which notifications you get, and how to watch a repository.

The Inbox in the header has two tabs. Needs you lists the work that waits on you right now. Activity lists what happened to your changes, requests and threads. Open it from the header or press g then i.

The header’s Inbox button shows a count of what needs you, and a dot when you have unread activity. Both update live.

Needs you#

Needs you covers every repository you can write to, grouped by repository. It isn’t a list of messages: an item stays until the thing it points to is dealt with, and goes away by itself once it is.

The groups, in order:

GroupWhat’s in it
Bake-offs waiting for your pickRequests whose Bake-off has a recommendation, or whose merge conflicted.
Requests to triageRequests from people without write access, waiting for someone with write access to accept or decline them.
Approved, ready to mergeChanges someone approved that haven’t merged yet.
ConflictedChanges that couldn’t merge because they conflict with their target.
Changes requestedOpen changes you authored where a reviewer requested changes on the latest revision. A change leaves the list when that reviewer approves it or you push a new revision.
Changes to reviewOpen changes you could approve. Bake-off candidates aren’t listed: you decide those as a whole. If the repository requires approval from someone other than the author, your own changes aren’t listed.
Assigned to youRequests with a running attempt assigned to you.
Your requests waiting for an attemptRequests you filed that have no attempt and no changes.

Each repository’s Overview tab shows the same lists for that repository, plus branches you pushed that you could propose as a change.

Activity#

Activity lists notifications, newest first, grouped by the change, request or commit they’re about. Click one to open it at the thread it concerns; that marks it read. Mark all read clears the unread dot. Older loads the next page.

Notifications are kept for 90 days.

You never get a notification for something you did yourself. Agents don’t get notifications. When an agent you started comments on its own work, you don’t get a notification for each comment: you hear once, when the agent finishes.

Choose your notifications#

Go to Settings → Account, section Notifications. Each kind has a checkbox, and all are on by default. Switching one off hides those notifications from Activity and from the unread count.

SettingYou’re notified when
MentionsSomeone writes @ and your handle in a comment.
RepliesSomeone adds a comment to a thread you took part in.
New threadsSomeone starts a thread on your change or request.
ApprovalsSomeone approves your change.
ReviewsSomeone submits a review of your change, or a review replies in a thread you took part in. You get one notification per review, not one per comment in it.
New revisionsA change you took part in gets a new revision.
MergedA change you took part in is merged.
ClosedA change you took part in is closed.
Couldn’t mergeYour change conflicts with its target.
AgentsAn attempt you started submits or fails, or a Bake-off you started recommends a winner.
AssignmentsSomeone assigns you a request.
CI failuresA CI run for your change, your push or your agent’s work fails, or can’t run because its workflow has errors.
Stopped schedulesScheduled CI runs in a repository you administer stop because the person they run as can no longer write to it. See Schedules.
TriageSomeone without write access files a request in a repository you watch and can write to, or a request you filed (or your agent filed) is accepted or declined, with the reason.
Watched repositoriesA new change or request is opened, or a change is merged, in a repository you watch. A request from someone without write access reaches you once it’s accepted, unless you can write to the repository.

“Your change” is a change you authored, or one an agent made on your behalf. “Took part in” means you own the change, approved it, or commented on it.

A review that approves your change reaches you once, under Approvals. Mentions inside a review still notify the people mentioned.

Watch a repository#

To hear about everything in a repository, not just your own work, click Watch in the repository header. The button turns into Watching; click it again to stop. Watching is off by default, and you need to be able to read the repository.

While you watch a repository, Activity tells you when:

  • someone opens a new change,
  • someone files a new request,
  • a change is merged.

Watching starts from the moment you click, so you don’t get a backlog. Bake-off candidates don’t count as new changes: a Bake-off with five lanes would be five notifications, and the one that’s picked shows up when it merges.

Watched-repository notifications can be switched off as a group with the Watched repositories setting, without unwatching each repository.

Command menu
Search for a page, repository, change or request, or run a command