Docs / Build
Reviews
Review requests that send stories to a stakeholder for a decision: approved or changes requested.
When to use it
When a story needs sign-off from a client or stakeholder.
Start here
Click "Request Review", enter the client's name or pick a team member, and select the stories to send.
How to use it
- Click "Request Review" to open "Request Story Review".
- Choose "Portal Client" and enter the client or reviewer name that will appear on their review portal, or choose "Team Member" and pick a member of this project from the list.
- Search for one or more stories, then click "Request Review". One review is created per story.
- For a portal client, click the copy icon ("Copy review link") on the row and send the link. The icon shows only for the person who requested the review, the project owner and members who manage the project.
- The reviewer opens the link, chooses "Approve" or "Request Changes", can add a comment, and clicks "Confirm Decision".
- To record a decision in the app, click "Decide" on a pending row, choose "Approve" or "Request Changes", add an optional comment and save. "Decide" shows only when the review is addressed to you, or you own or administer the project.
- To approve several at once, tick the pending rows you are allowed to decide (or the header checkbox) and click "Approve All Selected".
- Switch between the All, Pending, Approved and Changes Requested tabs to filter. The counters show Total, Pending, Approved and Changes.
Good to know
- A review addressed to a team member can be decided only by that person or by a project owner or admin. Owners and admins can also record a decision for a portal client.
- Requesting a review from the same reviewer again withdraws that reviewer's earlier pending request. Requests to other reviewers stay, so several people can review one story.
- A story's review status is pending while any of its reviews is pending, then changes requested if anyone asked for changes, otherwise approved.
- Reviews of features and epics requested from the Backlog can appear in this table alongside story reviews.
- The "All" tab and the counters leave out withdrawn reviews.
Related
Last updated 6 October 2026