Skip to content

Reviewing

Inbox and reviews

Work through what needs you, with notifications in the Inbox and review requests in a workspace's Reviews page.

Two pages answer "what do I need to do?". The Inbox is every notification you get, across all your workspaces. Reviews is the list of review requests in one workspace, with the list on the left and the selected request on the right. Both are in the sidebar with a count of what is waiting.

Open it with gtheni. It has three tabs:

Tab Shows
For you Notifications that need you
Everything Every notification you've had
Snoozed Notifications you put off, with their count beside the name

What lands here, and why:

  • Review requested or asked again: someone, or a review rule, asks you to review a build.
  • Mentioned: someone @mentioned you in a comment. The notification shows the start of the comment and a reply box.
  • Your build was approved or rejected: a build you pushed was reviewed. A rejection shows the reviewer's reason.
  • Review overdue: a request to you has waited past the project's review target. Sent once. Someone else's overdue review can also reach you if you are the person the project tells when it's missed.
  • Assigned to you as the person on triage: see Triage and flaky screenshots.
  • Connection needs attention: a connection of the workspace, such as a git host or Slack, stopped working, and the notice says which one and why. It goes to the workspace's owners and admins only. Its Reconnect button opens that connection's page in the workspace's integrations settings. It is the one place the Inbox leads into settings; everything else here opens the app.

Which of these also arrive by email or push is set in Account settings. Notifications lists every kind and the rules for what is sent. You can't turn off Inbox notifications; snooze or delete single items instead.

CirCI
The Inbox with the For you tab open: a list of notifications such as a triage assignment and overdue reviews, each with an unread dot, and the selected one open on the right with Mark read, Delete, Snooze, Open review and Approve all.
The For you tab. The selected notification is open on the right, with its actions at the bottom.

A row shows an unread dot, who did it, what happened, the project, and the age. Select a row to read it in the pane on the right. The pane's buttons are:

Button Key Does
Mark read / Mark unread u Toggles
Delete Backspace Removes the notification (with Undo)
Snooze, or Unsnooze on the Snoozed tab h Tomorrow, Next week or a Custom date; Unsnooze brings it back, and its toast has Undo
Open review, Open build, Open thread, Open project Enter Goes to where it happened
Approve all ShiftA Only when the notification is a request on a build that still waits: approves the whole build

Mark all read in the header clears the unread count. Opening or selecting a notification marks it read.

On a phone the selected notification opens over the list. To install the dashboard as an app, see Account settings.

Open it from the sidebar, or with gthenr. It lists the review requests of the current workspace in five tabs:

Tab Shows
Requested from you Open requests addressed to you. Grouped as Needs your review, Re-requested (a new build or a nudge asked again), and Still processing
Reviewed Requests you answered
Created by you Requests you made, waiting on the reviewers
All open Every open request in the workspace, as Requested from you, Requested from others and Still processing
Snoozed Requests you put off

A build that is still being compared is under "Still processing" because there is nothing to review yet.

The selected review is in the page's address, so copying the link shares that review. j and k move through the list and Enter opens the build. The find field filters the list.

CirCI
The Reviews page. Five tabs above a list of review requests, each with a build number, project, branch and an Overdue badge. The selected build is open on the right with its details and a thumbnail of the changed screenshot.
Requested from you. The selected request shows who asked, the review target and the changed screenshots.

The right side shows the request: the status, the build number, the project, the pull request and commit, who asked and when, the review target with an Overdue note when it has passed, what the build was compared with, and the changed screenshots as thumbnails grouped by size of change (Large, Medium, Small, Not measured) with their pixel percentage. A Flaky chip appears when some changed screenshots are known to be flaky. Go to review opens the build page. See Reviewing a build.

Other actions:

  • Snooze (h) puts a request away. Choose Until next push (it wakes when a newer build closes the request), Tomorrow, Next week or a Custom date. Unsnooze on the Snoozed tab brings it back (also in the right-click menu and the command menu).
  • Dismiss removes a request from your list. It isn't offered on Reviewed requests, or on requests that wait on someone else.
  • Nudge appears when you asked someone and they haven't answered. It sends them a "review again" notice, once per 24 hours.
  • Request review (ShiftR) asks another member about the same build.
  • Approve is in the row's right-click menu, for requests addressed to you on a build that has finished processing.

Snoozing, unsnoozing and approving can be undone from the toast. Dismiss can't be. See Undo.

A push notification can tell you a review landed when the page isn't open. Turn it on in Account settings.

Key Does
g i / g r Open Inbox / Reviews
j / k Next / previous item
Enter Open
CommandEnter Open in a new tab
h Snooze
f Filter the list

? lists all of them, and Keyboard shortcuts has the full list.