Docs / Deliver
Approvals
Approval requests and workflows: pick a PRD, story, epic or timesheet and record an approve or reject decision, with comments, in one step or several. Only someone the step allows can decide.
When to use it
When you want a recorded sign-off, with comments, on a piece of work. Approving a PRD or timesheet takes effect on it.
Start here
Click "New Request" and pick the item, or create a workflow first if you need multiple approvers.
How to use it
- To require several approvers, open the "Workflows" tab first and click "New Workflow". Give it a "Name", choose an "Item type" and leave "Active" on.
- Add steps with "+ Add Step". Each step has a label and a choice of who may approve it: anyone on the project, a role or higher (Viewer, Editor, Admin, Owner) or a custom role held on this project. Click "Create Workflow".
- Open the "Requests" tab and click "New Request". Choose an "Item type" of PRD, Story, Epic or Timesheet, then pick the item itself: search for a story or epic, or choose a PRD or a submitted timesheet from the list.
- Optionally enter a "Title" (it defaults to the item's name) and a "Description". Under "Workflow (optional)" pick one of the active workflows for that item type, or leave "None (single step)". Click "Create Request".
- Each request card shows the item, its status, "Step X of Y" with a dot for every step, and who it is "Waiting for". Use the filters (All, Pending, Approved, Rejected, Cancelled) to narrow the list.
- "Approve" and "Reject" appear on a pending request only when you may decide its current step. Add an optional comment and confirm. Rejecting stops the approval chain.
- Click "Cancel" on a pending request to withdraw it. Only the requester or the project owner sees the button.
- Click "Show decisions" on a request to see who decided at each step, the outcome, the date and any comment.
Good to know
- Your role on the project must satisfy the step, and the project owner can decide any step. You cannot decide your own request or two steps of the same request, and the owner is the exception to both rules.
- Approving a PRD request marks that PRD approved. Approving or rejecting a timesheet request approves or rejects that week. For a story or epic the outcome is recorded and shown as an "Approval:" badge in the Backlog; it does not change the item's status.
- To decide a PRD request you also need permission to edit the backlog, and for a timesheet request permission to approve timesheets. Workflows for those two types cannot have a step open to "Anyone on the project" or "Viewer or higher".
- A workflow's steps are copied into each request when it is created, so editing a workflow does not change pending requests. An item can have one pending request at a time. Only active workflows of the matching item type can be chosen; use "Deactivate", "Edit" or "Delete" on a workflow.
- Requests made before items could be picked show "No linked item" and can only be cancelled.
Related
Last updated 6 October 2026