Create a document approval workflow

The highlighted information on this page refers to functionality not yet generally available. It is available only in the Preview Sandbox environment.

You can request approval from other users or teams for a document in Adobe Workfront, or request they review a document without needing to approve it.

IMPORTANT
The content of this article refers to updated document approval functionality that is only available for specific accounts. For information on standard approval processes, see the articles listed in Work approvals.

Access requirements

Expand to view access requirements for the functionality in this article.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package

Any Workfront package to manage approvals using legacy Workfront storage

Any Workflow package to manage approvals using Adobe cloud storage

Adobe Workfront license

Contributor or higher

Review or higher

If you are using the Frame.io integration, you must have a Standard license to create approval workflows.

Access level configurations View or higher access to Projects, Tasks, Issues, Templates, Portfolios, Programs, Reports, Dashboards, and Calendars, Documents
Object permissions Manage access to the object associated with the request access or approval

For information, see Access requirements in Workfront documentation.

Create an approval workflow in the legacy documents area in Production

If your organization is on Workfront storage, you will see the legacy documents area when you access documents in Workfront. For more information about Workfront storage, see Differences between Adobe cloud storage and legacy Workfront storage.

To create an approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document you need and the Document Summary panel for that document opens.

  3. Select the version of the document you would like to create an approval for in the version dropdown. The latest version is selected by default.

  4. Scroll down to the Approvals section, then click Create workflow.

  5. Fill in the following details:

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    Stage name Add a stage name. You can change the name to something more descriptive, such as Initial Review or Final Approval.
    Add names or emails Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made.
    One decision required (optional) The first person who makes a decision completes the stage.
    Due date (optional) Set a due date for the approval. Users and teams are notified by email 72 hours, then 24 hours before the specified due date.
  6. (Optional) Repeat the previous step to add additional stages as needed.

    note
    NOTE
    If you add multiple stages, the approval workflow proceeds in the order the stages are listed. When all required decisions are made, the next stage begins and the previous stage is locked.

    Document details

Create an approval workflow in the legacy documents area in Preview

If your organization is on Workfront storage, you will see the legacy documents area when you access documents in Workfront. For more information about Workfront storage, see Differences between Adobe cloud storage and legacy Workfront storage.

Create a basic approval workflow

To create a single-stage approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document you need and the Document Summary panel for that document opens.

  3. Select the version of the document you want to create an approval for in the version drop-down menu. The latest version is selected by default.

  4. Scroll down to the Approvals section, then click Create workflow. The Request approval dialog opens in Basic mode.

  5. Fill in the following details:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 html-authored no-header
    Use an approval template (optional) Select a template from the drop-down menu. If the template has one path and one stage, it applies in Basic mode. If the template has more than one stage or more than one path, the dialog automatically switches to Advanced mode and any input you entered in Basic mode is replaced by the template's content.
    Add names or emails Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made.
    Only one decision required (optional) The first person who makes a decision completes the stage.
    Due on (optional) Set a due date for the approval. Users and teams are notified by email 72 hours, then 24 hours before the specified due date.
    Add Custom Message (optional)

    Type a message in the Add Custom Message text box. The message appears in the approval email notification and in the Approvals tab in Workfront.

    Note: If you edit a custom message after the approval workflow is created, an updated email notification is sent to all existing participants. If you add a participant later, the custom message is included in their email notification.

  6. Click Request approval.

    Request approval in Basic mode

Create an advanced approval workflow

Advanced mode supports multiple stages as well as parallel paths. Each path runs independently and contains one or more sequential stages. When all required decisions in a stage are made, the next stage in that path begins, the previous stage is locked, and the new stage’s reviewers and approvers receive an email notification.

A “Needs work” decision stops the path its on but does not affect the approval workflow on other paths. You can configure up to 30 paths and 100 stages total.

To create an advanced approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document you need and the Document Summary panel for that document opens.

  3. Select the version of the document you want to create an approval for in the version drop-down menu. The latest version is selected by default.

  4. Scroll down to the Approvals section, then click Create workflow.

  5. In the top right of the Request approval dialog, click Go to advanced. Any input you entered in Basic mode is preserved and applied to Path 1, Stage 1.

    note tip
    TIP
    While you’re creating the approval, you can return to Basic mode by clicking Go to basic in the top right. After you click Request approval, the Go to basic option is no longer available.
  6. Fill in details for Stage 1 of Path 1:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 html-authored no-header
    Stage name Stages are named Stage 1, Stage 2, and so on by default. Rename the stage to something more descriptive, such as Initial Review or Final Approval.
    Add names or emails

    Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made.

    Note: A reviewer or approver can be assigned to only one open stage at a time on the same asset. If multiple parallel stages are open simultaneously, the same person can't be added to more than one.

    Only one decision required (optional) The first person who makes a decision completes the stage.
    Due on (optional) The first stage of each path supports an absolute due date. Each subsequent stage in the path supports a relative due date — the number of days from when that stage opens. Users and teams are notified by email 72 hours, then 24 hours before the due date.
    Add Custom Message (optional)

    Type a message in the Add Custom Message text box. The message appears in the approval email notification and in the Approvals tab in Workfront.

    When you add a second stage, Show this message on all stages is selected by default. Leave it selected to use the same message in every stage. To use a different message for each stage, clear Show this message on all stages, then type the stage-specific message in each stage's Add Custom Message text box.

  7. (Optional) Click Add stage to add another stage to the path. Stages within a path run sequentially in the order they’re listed. You can reorder stages within a path, but you can’t move a stage from one path to another. Each path can have a different number of stages.

  8. (Optional) Under Parallel paths, click Add path to add another path. The new path starts with one empty stage and becomes the selected path. To rename a path, hover the path label, click the pencil icon, then type a new name.

  9. (Optional) To remove a path, hover the path label and click the trash icon. Path 1 can’t be removed, and paths can’t be reordered. Other paths can be removed only if no stage within the path is locked or completed.

    Advanced mode with parallel paths

  10. (Optional) To clear all paths and stages and start over, click Reset in the top right.

  11. Click Request approval.

Create an approval workflow in the new Documents area in Production

If your organization uses Adobe cloud storage, you will see the new Documents area when you access documents in Workfront. For more information about Adobe cloud storage, see Adobe cloud storage overview.

To create an approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document, then click the Approvals icon on the right side of the page.

    Add approvers in document summary

  3. Click Create workflow, then fill in the following details:

    table 0-row-2 1-row-2 2-row-2 3-row-2 html-authored no-header
    Stage name Add a stage name. You can change the name to something more descriptive, such as Initial Review or Final Approval.
    Add names or emails Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made.
    One decision required (optional) The first person who makes a decision completes the stage.
    Due date (optional) Set a due date for the approval. Users and teams are notified by email 72 hours, then 24 hours before the specified due date.
  4. (Optional) Repeat the previous step to add additional stages as needed.

    note
    NOTE
    If you add multiple stages, the approval workflow proceeds in the order the stages are listed. When all required decisions are made, the next stage begins and the previous stage is locked.

    Document details

Create an approval workflow in the new Documents area in Preview

If your organization uses Adobe cloud storage, you will see the new Documents area when you access documents in Workfront. For more information about Adobe cloud storage, see Adobe cloud storage overview.

The Request approval dialog opens in Basic mode by default. Basic mode is a single stage with one set of approvers or reviewers. Switch to Advanced mode to configure multi-stage approvals or parallel paths.

Create a basic approval workflow

To create a single-stage approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document, then click the Approvals icon on the right side of the page.

    Add approvers in document summary

  3. Click Create workflow. The Request approval dialog opens in Basic mode.

  4. Fill in the following details:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 html-authored no-header
    Use an approval template (optional) The templates field is collapsed by default. Click the field to expand it, then select a template from the drop-down menu. If the template has one path and one stage, it applies in Basic mode. If the template has more than one stage or more than one path, the dialog automatically switches to Advanced mode and any input you entered in Basic mode is replaced by the template's content.
    Add names or emails Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made.
    Only one decision required (optional) The first person who makes a decision completes the stage.
    Due on (optional) Set a due date for the approval. Users and teams are notified by email 72 hours, then 24 hours before the specified due date.
    Add Custom Message (optional) Type a message in the Add Custom Message text box. The message appears in the approval email notification and in the Approvals tab in Workfront.
  5. Click Request approval.

    Request approval in Basic mode

NOTE
  • The Request approval dialog opens in Basic mode every time, regardless of your previous session.
  • If you edit a custom message after the approval workflow is created, an updated email notification is sent to all existing participants. If you add a participant later, the custom message is included in their email notification.
  • After an approval is saved, you can’t switch it back to Basic mode. You can switch an in-progress approval from Basic to Advanced as long as the approval is not locked or completed.

Create an advanced approval workflow

Advanced mode supports parallel paths. Each path runs independently and contains one or more sequential stages. When all required decisions in a stage are made, the next stage in that path begins, the previous stage is locked, and the new stage’s reviewers and approvers receive an email notification.

A “Needs work” decision stops the path its on but does not affect the approval workflow on other paths. You can configure up to 30 paths and 100 stages total.

To create an advanced approval workflow:

  1. Go to the project, task, or issue that contains the document, then select Documents in the left panel.

  2. Click on the document, then click the Approvals icon on the right side of the page.

    Add approvers in document summary

  3. Click Create workflow.

  4. In the top right of the Request approval dialog, click Go to advanced. Any input you entered in Basic mode is preserved and applied to Path 1, Stage 1.

    note tip
    TIP
    While you’re creating the approval, you can return to Basic mode by clicking Go to basic in the top right. After you click Request approval, the Go to basic option is no longer available.
  5. Fill in details for Stage 1 of Path 1:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 html-authored no-header
    Stage name Stages are named Stage 1, Stage 2, and so on by default. Rename the stage to something more descriptive, such as Initial Review or Final Approval.
    Add names or emails

    Begin typing a user or team name to add as an approver or reviewer. If you only have reviewers, they will be notified and have the option to complete the review but no decision will be required or made..

    Note: A reviewer or approver can be assigned to only one open stage at a time on the same asset. If multiple parallel stages are open simultaneously, the same person can't be added to more than one.

    Only one decision required (optional) The first person who makes a decision completes the stage.
    Due on (optional) The first stage of each path supports an absolute due date. Each subsequent stage in the path supports a relative due date — the number of days from when that stage opens. Users and teams are notified by email 72 hours, then 24 hours before the due date.
    Add Custom Message (optional)

    Type a message in the Add Custom Message text box. The message appears in the approval email notification and in the Approvals tab in Workfront.

    When you add a second stage, Show this message on all stages is selected by default. Leave it selected to use the same message in every stage. To use a different message for each stage, clear Show this message on all stages, then type the stage-specific message in each stage's Add Custom Message text box.

  6. (Optional) Click Add stage to add another stage to the path. Stages within a path run sequentially in the order they’re listed. You can reorder stages within a path, but you can’t move a stage from one path to another. Each path can have a different number of stages.

  7. (Optional) Under Parallel paths, click Add path to add another path. The new path starts with one empty stage and becomes the selected path. To rename a path, hover the path label, click the pencil icon, then type a new name.

  8. (Optional) To remove a path, hover the path label and click the trash icon. Path 1 can’t be removed, and paths can’t be reordered. Other paths can be removed only if no stage within the path is locked or completed.

    Advanced mode with parallel paths

  9. (Optional) To clear all paths and stages and start over, click Reset in the top right.

  10. Click Request approval.

recommendation-more-help
workfront-help-quicksilver