The review queue

Find the workflow runs that are waiting for you, and open one to review it.

For: Any signed-in user · Last updated

Some workflows stop at a step that asks a person to look at what has been made before the run continues. The review queue is where those runs wait for you. The queue follows the Workflows switch on Settings, then Features; when that switch is off, the queue is absent.

Open the queue#

Open your profile menu (your name at the right end of the top bar) and select Review queue. When something is waiting for you, a number beside the item shows how many are pending, and the same number counts toward the badge on your name. The item appears in your menu once you have a review of your own, whatever your role: a run that is for you, a run you started, or a review that names you or your team. If you have none, the menu does not show it. The number counts the reviews you can decide. A review that someone else was chosen to decide appears in your list, marked, but is not counted.

The page is titled Waiting on you. Its tabs are Pending, Approved, Rejected and All. The Pending tab shows the count in brackets and refreshes on its own. When nothing is waiting, it says "Nothing is waiting for you."

Each row shows the workflow's name, a short run number, the step that stopped, who the review is assigned to when the workflow names a person or a team (for example Assigned to Nadia Chen or Assigned to the Benefits team), the start of the instructions for what to check, how long ago it stopped, and a label. The label reads Review for a step that asks for a person's review, or Guardrail check when an automatic check stopped the run and needs a person to decide. Decided items show Approved or Rejected. Select Show more to load further items.

Who sees an item and who decides it#

By default, the person a run is for decides its reviews. Being an administrator does not give you access to other people's runs: you see a run's reviews only when the run is for you, you started it, or you are the person or team assigned to review. A workflow can instead name a specific person or a team to review a step:

  • With a specific person, that person sees the review in their queue and can approve or reject it.
  • With a team, the review appears in every team member's queue and counts toward each member's badge. Any one member can approve or reject it. The first decision counts; if someone else has already decided, you are told the item has already been decided. The page afterwards shows who decided.
  • In both cases, the person who started the run can still open the run, the review and its files, but cannot decide it. Their row says You can follow this review but not decide it.

Everyone who can see a run's reviews can also open the run's files and previews. No one else can open them, administrators included.

Open an item#

Select a row to open it. The page shows the workflow's name, the run's status and three panes: Inputs, Review Thread and Outputs. Select Open the full run to see the whole run page instead, and the Review queue link to go back.

Reviewing a run describes what you can do from here.