Create an approval process for work items
You can create an approval process that users can attach to a work item (project, task, issue, template, or template task), a document, or a proof. An approval process ensures that designated assignees on the object review certain changes before the object progresses in the system.
This article describes how to create a system-level or group-level global approval processes for work items (project, task, issue, template, or template task).
For information about approvals associated with documents or proofs, see the following articles:
Access requirements
You must have the following access to perform the steps in this article:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
۶Ƶ Workfront plan |
System-level or single-use approval process: Any Group-level approval process: Prime or Ultimate |
۶Ƶ Workfront license |
New: Standard or Current: Plan |
Access level configurations |
If you are a system administrator or you have administrative access to approval processes, you can create a system-level approval process, or a group-level approval process for a particular group. If you are a group administrator, you can create group-level approval processes for groups that you manage. |
For more detail about the information in this table, see Access requirements in Workfront documentation.
Create a system-level or group-level global approval process for work items
-
Click the Main Menu icon in the upper-right corner of ۶Ƶ Workfront, or (if available), click the Main Menu icon in the upper-left corner, then click Setup .
-
(Conditional) If you are creating a system-level approval process, click Processes > Approvals in the left panel.
Or
If you are creating a group-level approval process, click Groups , click the name of the group, then click Approvals.
-
Choose either the Project Approvals, Task Approvals, or Issue Approvals tab.
-
Click New Approval Process.
-
Specify the following information in the box that displays:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Approval process name Type a descriptive name for the approval process. Users see this name when applying the approval process to an object, as described in Associate a new or existing approval process with work. Description Type a description of the approval process. This displays in the Approvals section in the Setup area next to the name of the approval process. Is Active Keep this option enabled if you want other users to be able to attach the approval process to projects, tasks, and issues that they create.
This option is enabled by default.
Tip: Marking an approval process as inactive is useful when your organization no longer needs to use it, but you want to preserve historical information about its use.
This approval process can be used by If you want the approval process available for projects, tasks, issues, and templates belonging only to a particular group, start typing the name of the group, then select the name when it appears:
- If you are a system administrator or you have administrative access to approval processes, you can see any group in the system when you type its name. All groups is selected by default.
- If you are a group administrator without administrative access to approval processes, you can assign the approval process to any group you manage when you type its name. The All Groups option is not available.
This option is not available for single-use approval processes.
WARNING: When you make changes to the group-specific approval process, the existing approval processes that have already been associated with work items might change. For information about these changes, see How group and approval process changes affect assigned approval processes.
For information about listing and managing your group's approval processes from your group's page, see Group-level approval processes.
For information about administrative access to approval processes, see Grant users administrative access to certain areas.
-
Configure a path for the approval process using the following options.
A path is where you specify what needs to happen in the approval process. You create stages in a path to indicate who needs to do the approval work and in what order.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Start approval process when the status is set to Select the status that will trigger the approval process on work items. When someone updates a work item to this status, its approval process begins.
The same status cannot be selected for multiple approval process paths.
The statuses available are based on what is selected under the option This approval can be used by (explained in the table above):
-
If All groups is selected, only system-wide statuses are available
-
If a specific group is selected, only the statuses available for that group are available
For information about how approval process work with statuses, see the section How approval processes rely on statuses in the article Approval process overview.
Stage Name (Optional) Type a name describing the first stage of the path. If you do not specify a stage name, the default name is Stage 1. Approvers Begin typing the name of the user, team, or job role that you want to designate as an approver for this stage, then click the name when it appears in the drop-down list. You can add only active users, job roles, and teams.
TIP:
When adding a user as an approver, notice the avatar, the user's Primary Role, or their email address to distinguish between users with identical names. Users must be associated with at least one job role to view it as you add them.
You must have the View Contact Info setting enabled in your access level for Users to view users' emails. For information, see Grant access to users.
NOTE:
Adding a user, team, or role as an approver does not automatically give them permissions to the object associated with that approval. They receive permissions to the object when the approval step is triggered. Otherwise, the objects must be shared with them before they can make an approval decision.
You can also designate an individual as an approver by specifying the individual’s role. For example, you can assign a Project Owner, Project Sponsor, Portfolio Owner, Program Owner, or Manager as an approver. These options automatically appear when you begin typing.
IMPORTANT:
- When you assign an approval to the Project Sponsor and no one is designated as the sponsor of a project, the approval is reassigned to the Project Owner. If no one is designated as the owner of the project, the approval is assigned to the Workfront administrator.
- When you assign an approval to a role and the Approver not required to be on the project team (for approval processes that include a role) is disabled but there are no roles in the project team that match the role on the approval, the approval is reassigned to the Project Owner. For information about approval settings, see Configure global approval settings.
- When you assign an approval to the Project Owner and no one is designated as the owner of a project, the approval is reassigned to the main Workfront administrator as indicated in the Customer Info section in the Setup area. For information, see Configure basic information for your system.
You can repeat this process to add multiple approvers to the stage. A single stage can include a combination of users, teams, and job roles as approvers. There is no limit to the number of approvers you can add to a stage.
IMPORTANT:
When you assign job roles as approvers, all users associated with that job role that are also on the project team can make a decision on the approval.
When you assign a team as an approver, any user in that team can make a decision on the approval.
For more information about the project team, see Project Team overview. For more information about approving work, see Approving work.
Only one decision is required
(Displays only if you add multiple approvers to the stage)Select this option if any one of the approvers on the stage can approve or reject the work item during this stage. This action allows the work item to leave the stage.
When this option is not selected, all of the identified approvers must approve or reject the stage (in any order) before the item leaves the stage. If any one of the approvers rejects the stage, the process interrupts and starts over so that the required changes can be made. Then the approvers can approve or reject the stage once again.
When a team is designated as an approver, any member of the team can grant or reject a stage.
Add stage (Optional) Add another a stage to the path, using the options explained in the three rows above. You can add as many stages to the path as you need. Choose what happens when the approval is rejected Select the action you want to take if the work item is rejected at any stage of the path:
-
Create an Issue: (Available only for project and task approval processes) An issue is created in the project or task where the approval process is running. The default assigned resource on the task, or the owner of the project is assigned to the issue. By default, the name of the issue created is Approval Rejected (<Project or Task Name>). This is a Rejection Issue, entered under the task or the project, depending on the approval process where the rejection happened.
-
Set Status to: Choose one of the following:
-
Previous Status: The rejected project, task, or issue reverts to the status prior to the status that activates the approval process.
-
Any other status in the list: The rejected object moves to the status you choose, such as On Hold. You can choose one of the default statuses or a custom statuses you added to your Workfront system.
If you select a status associated with an approval process as the rejection status, the rejected object moves to the selected status and it will be marked as "Pending approval".
For example, if you select On Hold for the rejection status and the On Hold status is associated with an approval process, the rejected object is placed in the status of "On Hold - Pending approval" status, requiring the approval.
-
-
-
(Optional) Click Add path to add another path to the approval process, referring to the list of options in the previous step.
The new path must be associated with another status. The path triggers when the item is updated to show this status. You cannot have two paths for the same status.
-
Click Save.
-
Now that the approval process is created, continue with any of the following:
- Associate the approval process with specific projects, tasks, or issues throughout your system, as described in Associate a new or existing approval process with work.
- Outside of Workfront, notify users that the approval process is available for them to associate with their projects, tasks, or issues, as described in Associate a new or existing approval process with work.
- Create another approval process that is triggered if this approval process is rejected and the item takes on another status. This gives you a way to link approval processes together.
For information about editing an approval process, see Edit an approval process.
Associating an approval process with a work item
When you want to create an approval process for a work item (project, task, or issue), you
- Create the approval process first
- Create the work item
- Associate the approval process with the work item
For instructions on associating an approval process with a work item, see Associate a new or existing approval process with work.
Enabling users to modify global approval processes for a single work item
By default, users who have manage permissions on projects, tasks, and issues can create single-use approval processes on them. For information about adding single-use approval processes to projects, tasks, and issues, see the section Associate a single-use approval process with a project, task, issue, template, or template task in the article Associate a new or existing approval process with work.
Users can also change settings for a global approval processes associated with a work item. These changes affect only the project, task, or issue associated with the system-level approval process. For more information, see the section Modify a global approval process for use on a specific object in the article Associate a new or existing approval process with work).