Associate a new or existing approval process with work
This article describes how you can associate approval processes with work items. For information about associating approvals with proofs or documents, see the following articles:
You can associate a global or single-use approval process with a work item in ۶Ƶ Workfront. The following scenarios exist:
- Associate an existing global approval process with a project, task, issue, template, or template task. Some global approval processes are available to all groups in the system. Group-level global approval processes are available only to certain groups.
- Create a single-use approval process and associate it with an existing project, task, issue, template, or template task.
For more general information about approval processes, see Approval process overview.
For information about creating a global approval process, see Create an approval process for work items.
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 3-row-2 layout-auto html-authored no-header | |
|---|---|
| ۶Ƶ Workfront plan* | Any |
| ۶Ƶ Workfront license* | Work or higher |
| Access level* |
Edit access or higher to Projects, Tasks, Issues, or Templates Note: If you still don't have access, ask your Workfront administrator if they set additional restrictions in your access level. For information on how a Workfront administrator can change your access level, see Create or modify custom access levels. |
| Object permissions |
Manage permissions to the project, task, issue, or template For information on requesting additional access, see Request access to objects. |
To find out what plan, license type, or access you have, contact your Workfront administrator.
Considerations about associating approval processes with work items
In addition to the considerations described below, we recommend that you revisit the general considerations about approval processes in Workfront. For more information, see Approval process overview.
-
You must create the project, task, issue, template, or template task before the approval process can be associated with them.
-
When you attach an approval process to an item for a status that has passed and in which the item currently is, the approval process will not be triggered and no notifications are sent to the approvers.
Example: If a task is in the status of Complete and you attach an approval process associated with the Complete status, the approval does not trigger.
-
When you attach an approval process to the first status of an item (by using a template for tasks and projects, using the Queue Setup settings for issues, or defining the Task Settings of a project for new tasks), the approval processes are bypassed if the submitted approval is recalled. In this case, the approvers do not receive any notifications.
For more information about recalling approvals, see View approvals.
note tip TIP The first status for a task or issue is New. The first status for a project is the status selected by your Workfront administrator in the Project Preferences in your system. For information, see Configure system-wide project preferences. -
The association of approval processes with an object is not recorded in the Updates area for the object.
-
You cannot associate an approval process with a parent task.
-
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.
The following sections describe the different methods of associating an approval process to a project, task, or issue.
Associate a global approval process with a work item associate-a-global-approval-process-with-a-work-item
You can associate a global approval process with a work item (project, task, issue, template, template task).
The global approval process must be available to the group associated with the work item or to all groups in the system.
For information about how Workfront administrators can configure a global approval process for all groups in the system, and how group administrators can create approvals for a group, see Create an approval process for work items.
To associate an existing global approval process with a project, task, issue, template, or template task:
-
Go to the work item where you want to associate an approval process.
-
Click Approvals in the left panel.
You might need to click Show More, then click Approvals.
-
The approval process selected displays.
-
Expand the Use existing drop-down menu and select an existing approval process.
The approval process selected displays.
-
Click Save.
-
(Optional) Click Edit Approval Process if you want to modify the existing approval you attached to the item. This changes the global approval process to a single-use approval process. For more information, see the section Modify a global approval process for use on a specific object in this article.
Modify a global approval process for use on a specific object modify-a-global-approval-process-for-use-on-a-specific-object
Your Workfront administrator or group administrator creates global approval processes for you to use, as described in Create an approval process for work items.
Modifying a global approval process attached to an item is identical to modifying a single-use approval process.
You can modify a global approval process to suit any specific needs of the project, task, or issue that you associate with it.
- The approval process is modified only for the project, task, or issue you are associating the approval process with.
- Any future changes made by an administrator to the original global approval process do not reflect on the global approval process that you modified.
To modify a approval process already attached to an item:
-
Add a global approval process to the project, task, or issue.
For instructions, see the section Associate a global approval process with a work item in this article.
note important IMPORTANT Ensure that you click Save when adding the approval. -
After the global approval process is added, click the Edit icon
-
Make any changes to the existing approval process. For more information, see the section Associate a single-use approval process with a project, task, issue, template, or template task in this article.
-
Click Save, then click Save again to confirm that you want to convert the global approval process to a single-use approval process that is available only on this object.
Associate a single-use approval process with a project, task, issue, template, or template task associate-a-single-use-approval-process-with-a-project-task-issue-template-or-template-task
You can create a single-use approval process for use only on a specific project, task, or issue.
You can also associate a single-use approval process with a template or template task so that it is available on projects and tasks that are created from the template.
Creating an approval process in this way enables you to create a custom approval process to meet your needs. However, the approval process cannot be associated with other work items in the future.
Alternatively, you can modify a global approval process for a specific item and that also becomes a single-use approval process. For information, see the section Modify a global approval process for use on a specific object in this article.
To create a single-use approval process:
-
Go to the project, task, issue, template, or template task where you want to associate an approval process.
-
Click Approvals in the left panel.
You might need to click Show More > Approvals.
-
Click Create single-use.
-
Complete the steps beginning with step 6 in the section “Create a system-level or group-level global approval process for work items” in the article Create an approval process for work items.
note tip TIP After you attach the single-use approval process, it displays as “ <Custom>” in the Approval Process field inside the Edit box of templates and template tasks. For information about editing templates or template tasks, see the following articles:
Remove or delete an approval process from a work item
You can remove a global or group-level approval process or you can delete a single-use approval process from a project, task, or issue previously associated with it.
The following scenarios exist:
- Removing the global or group-level approval process does not delete the approval. The approval remains available for future use.
- Deleting a single-user approval process deletes it from Workfront and it cannot be recovered.
To remove or delete an approval process from a work item:
-
Go to the project, task, issue, template, or template task where you want to remove an approval process that you previously added.
-
Click Approvals in the left panel.
You might need to click Show More > Approvals.
-
Click one of the following icons in the upper-right corner of the Approvals section, depending on what type of approval is associated with the item:
- The Remove icon
- The Delete icon
- The Remove icon
-
Click Remove or Delete to confirm.
The approval process is removed from the work item.
Automatically associate an approval process with work items
You can associate an approval process automatically with work items using the following workflows:
- For projects and tasks, you can associate an approval process using a template. You can attach an existing approval process to the Template Approvals tab or the Template Task Approvals tab. For information about associating an existing approval with a work item, see Associate a global approval process with a work item in this article.
- For new tasks on an existing project, you can associate a global approval process or a group-level global approval process in the Task Settings area of the Edit Project box. For information, see the section “Task Settings” in the article Edit projects.
- For issues, you can associate an approval with every new issue that is added to a project by associating an existing approval process with a request queue. For information about configuring request queues, see Create a Request Queue.