# Document Templates · Tickets · Admin Portal

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

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-document-templates
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452e-0212-7ec9-b09a-c3da629167b4"></a>

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

<a id="element-01a1452e-0213-7d59-af52-65354c8f7329"></a>

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

<a id="element-01a1452e-0213-7a80-9ce2-c7b0971db5df"></a>

![Document Templates: The default view shows the list of already uploaded Document templates.](https://docs.mintsd.com/api/reader/assets/assets/images/image499.jpeg?v=40d01d8bf21bb4198e4c76ea10fed30ebb5b117b49eb58b9dabd862b410736f5)

<a id="element-01a1452e-0213-7595-a3e8-1bf6ca70e2a7"></a>

## Creating a document template

To add a new Document template simply click the button.

<a id="element-01a1452e-0214-72cd-ab97-cc88b88e28df"></a>

![Document Templates: To add a new Document template simply click the button.](https://docs.mintsd.com/api/reader/assets/assets/images/image500.JPG?v=11a65aa67eb65783d2102f153f65aee81c65e468f282b988fec89c13f3bb7392)

<a id="element-01a1452e-0214-7ca0-b54b-5429b6a32136"></a>

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’).

<a id="element-01a1452e-0215-7fc1-be05-243da64b1f7d"></a>

![Now, in the ‘Create document template’ put some name (‘Name’) for your template then select the Queues.](https://docs.mintsd.com/api/reader/assets/assets/images/image501.png?v=c21760cd2bf589eb937b723f8709a962043245dc1634a83fad8ec43c1e169b41)

<a id="element-01a1452e-0215-7821-9066-ec644bb19551"></a>

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

<a id="element-01a1452e-0216-77de-b458-cb05e84dd317"></a>

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.

<a id="element-01a1452e-0216-79f0-a3dc-a33b044cbb40"></a>

![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.](https://docs.mintsd.com/api/reader/assets/assets/images/image502.png?v=5fb5da1cb87c86086f0d0f32abfbb357cfa7c1b42ccfd01603badc9fbd2a777c)

<a id="element-01a1452e-0217-7569-958c-7f1966bad1fb"></a>

## 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.

<a id="element-01a1452e-0217-71ff-8da6-3076123b198b"></a>

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

<a id="element-01a1452e-0221-71e9-8119-b926e0f799ec"></a>

| Placeholder | Location/used in | Description |
| --- | --- | --- |
| {{PrintDate}} | Ticket Details | Date of creating a ticket .pdf preview. |
| {{TicketName}} | Ticket Details > Details | Ticket name/title. |
| {{TicketNumber}} | Ticket Details > Details | Ticket number. |
| {{Customer}} | Ticket Details > Details | Ticket owner’s name – a person who created the ticket. |
| {{Company}} | Ticket Details > Details | Company name of the ticket owner. |
| {{Status}} | Ticket Details > Details | Ticket current status. |
| {{Assignee}} | Ticket Details > Details | A person (Agent) assigned to the ticket. |
| {{Queue}} | Ticket Details > Details | Ticket Queue name. |
| {{TicketType}} | Ticket Details > Details | Ticket type name. |
| {{Priority}} | Ticket Details > Details | Ticket priority. |
| {{Service}} | Ticket Details > Details | Name of the chosen Service for the ticket. |
| {{Age}} | Ticket Details > Details | Ticket age (in hours or days). |
| {{TicketCreationDate}} | Agent/Client Dashboard | The exact date when the ticket was created. |

<a id="element-01a1452e-0221-7b83-a403-4a64f5fb486a"></a>

![Upload .docx templates for agents to use in tickets. Insert placeholders for ticket data and custom field values.](https://docs.mintsd.com/api/reader/assets/assets/images/image503.jpeg?v=2ce5229907ade14fbafeb270ab122a74903b611268f803084f8ae88b9802b522)

<a id="element-01a1452e-0222-7343-8ebf-e516fe8d81cb"></a>

![Upload .docx templates for agents to use in tickets. Insert placeholders for ticket data and custom field values.](https://docs.mintsd.com/api/reader/assets/assets/images/image504.jpeg?v=d7ba8d34cb52278991bed9bc5f9484f72703007cb680f3aba32e83c2c02992fe)

<a id="element-01a1452e-0222-75c1-8540-f7a52d8dca8d"></a>

## Custom field placeholders

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

<a id="element-01a1452e-0223-7464-b6c0-f5f26a39c1bb"></a>

{{GroupName:AttributeName}}

<a id="element-01a1452e-0223-7fd1-802a-b6989c8d83c1"></a>

Example:

<a id="element-01a1452e-0223-773d-8f5c-5a0521b8cd42"></a>

![Document Templates: Example:](https://docs.mintsd.com/api/reader/assets/assets/images/image1107.png?v=5efc27514827831b5074f83b86e2115e7c0476c99d4095761e68b0598cdfc0c5)

<a id="element-01a1452e-0224-73b0-be90-e735e03c3428"></a>

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

<a id="element-01a1452e-0224-7e61-8934-bab1ba2dd033"></a>

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

<a id="element-01a1452e-0225-7bc8-a2aa-f026c2e40078"></a>

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

<a id="element-01a1452e-0225-7bc1-be68-354e3fd142d6"></a>

![Document Templates: Below you can see how a prepared template document should look like.](https://docs.mintsd.com/api/reader/assets/assets/images/image505.png?v=f100e8895e0c4bc06e61d6c5addbbfc08087220c3889004c271f986ff68def2a)

<a id="element-01a1452e-0225-7ab6-bfbb-a513d1704abb"></a>

Placeholders are written in blue.

<a id="element-01a1452e-0226-7e9b-a8ab-926c5189a934"></a>

## 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.

<a id="element-01a1452e-0226-75f1-8a00-ace31c64faa0"></a>

![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.](https://docs.mintsd.com/api/reader/assets/assets/images/image506.jpeg?v=2498eb3640d6eff1cb0ceba2dbbde0e2ded9d495c306da67a990b0c674966972)

<a id="element-01a1452e-0227-7f8e-ae9d-2c2a13d4ae72"></a>

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.

<a id="element-01a1452e-0227-7480-b331-73a5349f9cbe"></a>

![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.](https://docs.mintsd.com/api/reader/assets/assets/images/image507.png?v=5bc6934e9a37bfe6e8452460f444d587a96d7cb30b23abbd3894bd7cecbe4d96)

<a id="element-01a1452e-0228-7b5c-ad3f-5fe2cf1770ef"></a>

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.

<a id="element-01a1452e-0228-71f2-adfe-e2ec4780014d"></a>

![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.](https://docs.mintsd.com/api/reader/assets/assets/images/image508.png?v=1fde0ae2ea4a75c409a7fda970b2a9b30f56165a17685e9a9856ac4005e6defa)

<a id="element-01a1452e-0228-726d-b5a1-d04ebd56758e"></a>

<a id="element-01a1452e-0229-71dc-b451-cd7db9de3d26"></a>

Once you decide that everything is in order click ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452e-0228-726d-b5a1-d04ebd56758e) button.
After that, you will notice a new position on the list of available
Document templates.

<a id="element-01a1452e-0229-7eea-abf8-7ff5e5d267a0"></a>

![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.](https://docs.mintsd.com/api/reader/assets/assets/images/image510.png?v=57a06ea24482f904548d9f4fecf50822a1f4f5a01c5529e2c0c64d6e00e78a18)

<a id="element-01a1452e-022a-760a-82f4-7d792a260825"></a>

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.

