Skip to content
Mint Service Desk Documentation centre

Document Templates

Upload .docx templates for agents to use in tickets. Insert placeholders for ticket data and custom field values.

Upload document templates for agents to use in ‘Ticket Details’.

The default view shows the list of already uploaded Document templates.

Creating a document template

To add a new Document template simply click the button.

Now, in the ‘Create document template’ put some name (‘Name’) for your template then select the Queues. Depending on your choice your template will be available to use only for tickets created in or moved to those Queues. If you want, you can also add some description (‘Description’).

Now you need to add an external file which contains the prepared Document template. MINT Service Desk only supports one file format: .docx.

To create such a Document template, you need to use external software e.g., Microsoft Word or any other which can save the file in .docx format.

System data placeholders

Use placeholders to insert system data. Enter {{Company}} in the template, for example. When an agent uses the template, {{Company}} is replaced with the client’s company name.

For the purpose of creating a Document template, you can add the fields below.

PlaceholderLocation/used inDescription
{{PrintDate}}Ticket DetailsDate of creating a ticket .pdf preview.
{{TicketName}}Ticket Details > DetailsTicket name/title.
{{TicketNumber}}Ticket Details > DetailsTicket number.
{{Customer}}Ticket Details > DetailsTicket owner’s name – a person who created the ticket.
{{Company}}Ticket Details > DetailsCompany name of the ticket owner.
{{Status}}Ticket Details > DetailsTicket current status.
{{Assignee}}Ticket Details > DetailsA person (Agent) assigned to the ticket.
{{Queue}}Ticket Details > DetailsTicket Queue name.
{{TicketType}}Ticket Details > DetailsTicket type name.
{{Priority}}Ticket Details > DetailsTicket priority.
{{Service}}Ticket Details > DetailsName of the chosen Service for the ticket.
{{Age}}Ticket Details > DetailsTicket age (in hours or days).
{{TicketCreationDate}}Agent/Client DashboardThe exact date when the ticket was created.

Custom field placeholders

To insert a custom field from Tickets or Users, use this syntax:

{{GroupName:AttributeName}}

Example:

For the “Desktop” and “Laptop” attributes, use {{Hardware:Desktop}} and {{Hardware:Laptop}}.

If Users and Tickets have the same group and attribute names, MINT uses the value from the ticket’s custom field.

Below you can see how a prepared template document should look like.

Placeholders are written in blue.

Uploading and saving

Now, when you have such a Document template ready you can upload it to the MINT Service Desk. In the ‘Files’ part click on the ‘Click to attach file’ field.

In your system’s file explorer find, select and add your custom-made Document template. Once you do that you will see a file miniature in the ‘Files’ part.

If you want to delete the file and add a new one you can do that by clicking the X button located at the top right corner of the file’s miniature the moment you move your mouse cursor over it.

Once you decide that everything is in order click button. After that, you will notice a new position on the list of available Document templates.

Now Agent can use it while communicating with a Client, inside the ‘Ticket details’ view. It was already described in the Agent > Ticket Details part of this guide.