Edit issues
You can edit information on issues that you have created, or that other users have created if they shared the issues with you.
You can edit a single issue or you can edit issues in a list. For information about editing issues in a list, see Edit issues in a list.
Access requirements
You must have the following access to perform the steps in this article:
*To find out what plan, license type, or access you have, contact your Workfront administrator.
Limitations when editing issues
There are some limitations that might prevent you from editing issues.
- You cannot edit issues that are in an Approval Process. You can only log time or update the status on an issue that is in Pending Approval.
- You can edit and add documents to issues on a project that has a status of Complete, Dead, or is Pending Approval only when your Workfront administrator or a group administrator enabled this functionality in the Project Preferences area. For information about setting project preferences, see Configure system-wide project preferences.
Edit a single issue
You can edit an issue using the Edit Issue or Issue Details areas. The following steps describe editing an issue in the Edit issue box.
-
Go to the Main Menu.
-
Click Projects, then click the name of a project to open the project.
-
(Optional) Click Tasks , then click the name of a task to open the task.
-
Click Issues in the left panel.
-
(Optional) To edit limited information about an issue, click Issue Details in the left panel.
note note NOTE Depending on how your Workfront administrator or Group administrator modified your Layout Template, the fields in the Issue Details area might be rearranged or not display. For information, see Customize the Details view using a layout template. To edit information in the Details section, do the following:
-
(Optional) Click the Collapse All icon in the upper-right corner to collapse all areas.
-
(Optional and conditional) When an area is collapsed, click the right-pointing arrow next to each area to expand the area you want to edit.
-
(Optional) To attach a custom form, start typing the name of a form in the Add custom form field, then select it when it displays in the list, then click Save Changes.
-
(Optional) Click the Export icon to export the Overview and custom forms information to a PDF file, then click Export. Select from the following:
- Select all (displays only when there is at least one custom form attached)
- Overview
- The name of one or multiple custom forms
The PDF file downloads to your computer.
For more information, see Export custom forms and object details.
For information about the fields visible in the Issue Details section, continue with editing the issue in the Edit issue box as described below.
-
-
To edit all information about an issue, select an issue in a list, then click Edit at the top of the list
Or
Click the name of an issue in a list then click the More menu next to the issue name, then Edit.
The Edit Issue dialog box displays.
note important IMPORTANT You must have Manage permissions to the issue in order to see the Edit link. All issue fields are available in the Edit Issue box and are grouped by the areas listed in the left panel.
-
Consider specifying information in any of the following sections:
note note NOTE Depending on how your Workfront administrator sets up our Layout Template, the fields in the Edit Issue box might be different in your environment. For information, see Customize the Details view using a layout template. Most fields listed in the sections below are also accessible from the New Issue box, when you create an issue. The sections under which the fields are located do not match the New Issue box. For information about creating issues, see Create issues.
Issue Name issue-name
-
Begin editing an issue as described above.
-
Click Issue Name.
-
Update the Issue Name field.
-
Click Save or continue editing the following sections.
Overview overview
-
Begin editing an issue as described above.
-
Click Overview.
-
Update or review any of the fields in the following table:
table 0-row-2 1-row-1 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 4-colspan-2 layout-auto html-authored no-header Description Add additional information about the issue. Basic information section Status Select the status of the issue. For more information about issue statuses, see Access the list of system issue statuses. Priority This is a visual flag for you which allows you to prioritize issues.
Select from the following options:
-
None
-
Low
-
Normal
-
High
-
Urgent
Depending on the Project Preferences selected by your Workfront administrator, the names of priorities might be different for you. For more information about editing priorities, see Create and customize priorities.
Severity This is a visual flag for you which indicates how severe the problem described in the issue is. Severities are specific to issues. Select from the following options:
-
Cosmetic
-
Causes Confusion
-
Bug with workaround
-
Bug with no workaround
-
Fatal error
Depending on the Project Preferences selected by your Workfront administrator, the names of severities might be different for you. For more information about editing severities, see Create or customize issue severities.
URL Type a web link that relates to the information about the issue. Type According to the Queue Properties selected by your project manager in the Queue Details area of the project, you might be able to specify the type of the issue. Select from the following options in the Type drop-down menu:
-
Bug Report
-
Change Order
-
Issue
-
Request
Depending on the Project Preferences selected by your Workfront administrator, the names of the types of the issues might be different for you.
Primary Contact By default, the Primary Contact is the creator of the issue. To modify this, start typing the name of any active user in Workfront, then select it from the list. An issue can have only one Primary Contact.
If you change the Primary Contact, the original primary contact still has Manage access to the issue. You must manually remove this access from the Issue Access box, when sharing an issue.TIP
When adding a Primary Contact user, notice the avatar, the user's Primary Role, and 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.
Commit Date and time This is the date when the assignee of the issue estimates that the issue will be completed. Only assignees can edit this field. Planned Start Date By default, the Planned Start Date is the date and the time when the issue was created. You can update the Planned Start Date of the issue. Planned Completion Date and time By default, the Planned Completion Date is 24 hours from the default Planned Start Date. By default, issues have a Duration of 1 day. You can update the Planned Completion Date of the issue. Actual Start Date and time The Actual Start Date is automatically populated when you change the status of the issue to In Progress. You can update the Actual Start Date of the issue. You can manually update the date, if needed. Actual Completion Date and time The Actual Completion Date is automatically populated when you change the status of the issue to Closed or Resolved. You can update the Actual Completion Date for the issue. You can manually update the date, if needed. Resolved By This shows whether the issue is resolved by another object. You can select whether this issue is resolved by a task, a project, or another issue from the drop-down menu, then start typing the name of the task, project, or issue that will resolve the issue. Select it when it appears in the list.
NOTE
When you select an object to resolve an issue, the issue status is linked to the status of the resolving object and cannot be changed on the issue. For more information about resolving objects, see Overview of Resolving and Resolvable Objects.
TIP
When your system or group administrator adds the “Resolved By” field to an issue custom header, the field changes to “Resolving Issue”, “Resolving Task”, or “Resolving Project” when there is a resolving object associated with the issue.
You cannot edit this field when it displays in the issue header. For more information about customizing issue headers, see Customize object headers using a layout template
Resolving Issue, Resolving Task, or Resolving Project The linked name of the issue, task, or issue that resolves the issue. This Resolves The linked name of the issue which completes when the issue you are accessing is resolved. -
-
Click Save or continue editing the following sections.
Assignments assignments
-
Begin editing the issue as described above.
-
Click Assignments in the left panel.
-
Click Search people, role and teams and start typing the name of a user, role, or team that you want to assign to the task, then click it or press Enter when it displays on the list.
note note NOTE If the user’s name contains a special character, you must include the special character in the search field. note tip TIP You can assign multiple users, job roles, or teams. You can assign only active users, job roles, and teams. If a user, job role, or team was assigned before they were deactivated, they remain assigned to the work item. In this case, we recommend the following: - Reassign the work item to active resources.
- Associate the users in a deactivated team with an active team and reassign the work item to the active team.
-
(Optional) Indicate whether an assignee is the primary assignee on the issue, by hovering over the name of the assignee and clicking Make Primary. A team cannot be the primary assignee of an issue.
-
Update the following fields:
table 0-row-2 1-row-2 layout-auto html-authored no-header Planned Hours This is the amount of actual time it would take the assignees of the issue to complete it. Type the number of Planned Hours for the issue.
Note: Changing the Planned Hours of the issue will not change the issue Planned Completion Date.
Assignee's Role Select a role from the Assignee's Role drop-down menu when you selected a person as an assignee. This is the role that the assignee can fulfill on this issue.
TIP
Only the job roles associated with each assignee in their profile appear in the drop-down menu.
-
Click Save or continue editing the following sections.
Custom Forms
-
Begin editing an issue as described above.
-
Click Custom Forms.
-
In the Add custom form field, select the custom form or forms that you want to associate with the issue. You must build the custom forms before they are available to select in this field. Only active custom forms display in the list. For more information about building custom forms, see Create a custom form. You can add up to ten custom forms to an issue.
-
(Conditional) If you attached a custom form to the issue, edit any fields on the form. You must specify all required fields before you can save the issue.
note note NOTE Depending on how your Workfront Administrator set the permissions for the sections in your custom form, not everyone can view or edit the same fields on a given custom form. The permissions to edit fields within a section of a custom form depend on the permissions you have on the issue itself. For information about setting permissions on sections of a custom form, see Create a custom form. For information about setting issue permissions, see Share an issue. -
Click Save or continue editing the following section.
Settings settings
-
Begin editing an issue as described above.
-
Click Settings.
Update the following information:
table 0-row-2 1-row-2 layout-auto html-authored no-header Approval Process Select an approval process that you want to associate with the issue. Your Workfront administrator must define system-level Approval Processes before you can associate them with issues. Users with administrative access to Approval processes can also create group-specific approval processes.For more information about creating Approval Processes, see Create an approval process for work items.
Consider the following when adding approval processes:
-
Only active approval processes display in the list.
-
System-wide and group-specific approval processes display in the list. An approval process associated with a group other than that of the project does not display in the list.
Important: If the group of the project changes, the group-specific approval process becomes a single-use approval process. For more information about how changes to the group of the project or changes in the approval process affect approval settings, see How group and approval process changes affect assigned approval processes.
-
You can define default approval processes to be automatically attached to issues when creating request queues or Queue Topics. For information about updating Queue Details, see Create a Request Queue. For information about creating Queue Topics, see Create Queue Topics.
-
When bulk-editing issues, the following scenarios exist:
-
When you select multiple issues from the same group, both system-level and group-specific approval processes display in this field.
-
When you select multiple issues from different groups, only system-level approval processes display in this field.
-
When any of the issues have a single-use approval process attached, it is replaced by the system-level or group-level approval process you select.
-
Reminder Notifications Select the checkbox for which Reminder Notifications you would like to attach to this issue. All reminder notifications for issues display. Your Workfront administrator must configure Reminder Notifications before you can select them on an issue. For more information about configuring Reminder Notifications, see Set up reminder notifications -
-
Click Save.
Edit an issue in the issue header (limited)
You can edit a limited amount of information in the issue header.
Your system or group administrator can customize the fields you see in the issue header. For information, see Customize object headers using a layout template.
The following fields are included in the issue header, by default:
- Issue name
- Percent complete
- Assignments
- Planned Completion Date and time
- Status
- Make approval decisions if you are set as the approver in a current approval process