Skip to main content

Jama Connect User Guide

Item workflow for Approval Reviews

When you integrate Approval Reviews with your item workflow, you ensure that reviews are consistent and up to date. When enabled by an organization admin, moderators can use templates for Approval and Peer reviews.


You have organization admin permissions to complete this task.

This overview describes the process for using item workflow with review templates.

  1. Organization admin — From Admin > Organization > Review center:

    1. Select Enable Approval review template. Approval reviews are required to integrate the workflow for your review process

    2. (Optional) Select Enable Peer review template. Peer reviews can be transition to Approval reviews.

    3. Click Save settings.

  2. Organization admin — From Admin > Organization > Workflow:

    1. Select Enable a workflow transition to be enabled by a finalized Approval review.

    2. Configure the workflow transition status, notifications, lock state, and permissions that apply to the new approval review transition.

  3. Moderator — Create a review, then select the Peer review template in the review wizard.

  4.  Moderator — View a Peer review and transition it to an Approval review.

  5. Moderator — When the Approval review is done, select Finalize Approval review.

  6. Moderator — After viewing the review overview and workflow transitions, select Finalize review to confirm the transition.

Types of review templates

The review templates are optional. You can use none, one, or both types. You don’t need a Peer review template to finalize an Approval review.


Review templates are disabled by default. You must enable the Approval and Peer review templates to use them.

  • Approval review template — Use when you want to collect signatures and need a review signed off. If workflow is enabled, you can batch update items to an approved state.

  • Peer review template — Use when you have a review with ongoing iterations and when changes to items are always in the “ready for approval” state.