task-mining
latest
false
UiPath logo, featuring letters U and I in white

Task Mining

Last updated Jun 16, 2025

Managing Task Mining templates

Introduction

With Template management you can upload custom templates for exporting the trace diagram as a Process description document in Microsoft Word format across all Task Mining projects in the current tenant. Template management allows you to customize templates to align with your business needs, such as incorporating your company logo and branding.

Note: Currently, only Task Mining projects support Template management. Other types of projects use the UiPath default template for export to PDD.
Important: To manage Task Mining templates on the tenant level, you need to have the Tenant Administrator platform role, or the Administrator service-level role in Task Mining

Uploading a template

Important: Always make sure the structure of the Word template is correct. We recommend you include the following placeholders in the template to ensure that all the data you documented displays properly in the Process definition document export file:
  • {title}
  • {description}
  • {author}
  • {email}
  • {execution_time}
  • {total_applications_count}
  • {total_actions_count}
  • {total_clicks}
  • {total_keys_pressed}
  • {total_text_entries}
  • {total_hotkeys}
  • {diagram}
  • {appsTable}
  • {appStatsTable}
  • {actionList}

To upload a custom template, take the following steps:

  1. In Task Mining, go to Administration.
  2. Select the Assisted Task Mining templates tab. The list of available templates displays.
    Note: The UiPath basic template is available and visible by default.
  3. Select Upload Template.
  4. Select the Select file button.
  5. Navigate to the .docx file you want to use as a template and select Open. An automatic checkd etects the available placeholders.
  6. a. If the structure is incorrect, select Cancel and add the required placeholders in the template file.

    b. If the structure is correct, select Continue.

  7. Enter a descriptive name and, optionally, a short description to indicate a specific usage for the template.
  8. Select Finish.
  9. To set the new template as default template for the whole tenant, select For whole tenant in the Set as templates as default message box, or select Cancel to continue.

You have now uploaded and added the template to the list of templates.

The following table displays the template properties:

PropertyDescription
Template nameThe display name of the template.
Visibility

The visibility status of the template.

Visible: the template can be selected when exporting a trace as a Process description document (PDD).

Hidden: the template is not available when exporting a trace as a PDD.

Default: the template is selected by default when exporting a trace as a PDD. The user can still select other visible templates when exporting a trace as  a PDD.  

DescriptionThe description to indicate a specific usage of the template.
Date addedThe date at which the template was uploaded.
AuthorThe name of the user who uploaded the template.
Times usedThe number of times the template was used for exporting a trace as a PDD.
ActionsOptions that enable you to download, or delete a template.

Troubleshooting

An error can occur when uploading a template file. The following table describes common error codes:
Error codeDescriptionPossible solution
TCW0088The .docx file used as a template for exporting the trace exceeds the maximum allowed file size of 5MB. Reduce the file size of the template file. For example:
  • Remove unused content or pages.
  • Compress or remove images.
  • Delete hidden or unused styles and content controls.
TCW0089The .docx file used as a template for exporting the trace is not in a valid .docx file format either due to corruption or an incorrect file format.
  • Ensure the file is an actual Word document (e.g., it’s not a PDF, TXT, or ZIP file that has been renamed to .docx)
  • Make sure the file format is correct and that the file was not damaged during upload, download, or by improper editing
  • Verify the file is not a non-standard .docx file created by third-party tools that do not fully conform to Office Open XML standards.
TCW0090The .docx file used as a template for exporting the trace has an invalid structure. Ensure that the structure of the Word template is correct and include the recommended placeholders to ensure that all the data you documented is displayed properly in the PDD export file.

Changing template visibility

Note: You cannot change the visibility of the UiPath basic template and the template that is selected as Default template.

Take the following steps to change template visibilty.

  1. Locate the template for which you want to change the visibility.
  2. Select the appropriate option in the Visibility column.

Downloading a template

You can download a template and use it as a basis for a new custom template by taking the following steps.

  1. Locate the template which you want to download.
  2. Select the Download option in the Actions column.

The template file donlnoads to your computer.

Deleting a template

You can delete a template if you no longer want to use it by taking the following steps.

  1. Locate the template for which you want to download and select the Delete option in the Actions column.
  2. A confirmation message is displayed. Select OK to delete the template file and remove it from the list of templates.

Changing the availability of templates

You can change the availability of templates for Business users and Recording users.

Note: Tenant Administrators, service-level Task Mining Administrators, and Project Administrators can always choose any template that is set to Visible.

The following table describes the possible options for template availability for Business users and Recording users:

OptionDescription
Use default template onlyIndicates that Business users and Recording users can only use the template that is set as the Default template for export to PDD. The default template is automatically used for the export and there is no option to choose a template.
Note: Use default template only is selected by default.
Allow to select any of visible templatesIndicates that Business users and Recording users can choose a template from
  • all templates that are set to Visible;
  • the template that is set as the Default template;
  • the UiPath basic template
for export to PDD.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2025 UiPath. All rights reserved.