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.
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.
Reviews
Section titled “Reviews”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.
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.
Keyboard shortcuts
Section titled “Keyboard shortcuts”| 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.