# Dictionaries · Fields Settings · Admin Portal

Create lists of selectable values, including nested values, display labels and restrictions by ticket parameters.

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

<a id="element-01a1452e-0bda-7bba-9a1d-623c9e185ce2"></a>

Define dictionaries and their values for fields of type ‘Dictionary’.

<a id="element-01a1452e-0bdb-7fae-931c-b43c32dbbafc"></a>

![Dictionaries: Define dictionaries and their values for fields of type ‘Dictionary’.](https://docs.mintsd.com/api/reader/assets/assets/images/image528.png?v=8b6839836dfe5e8720639d926a21847fb77631cc6168b851f478cce098f78ca6)

<a id="element-01a1452e-0bdb-75df-97c6-4934fba2c5cd"></a>

Create, edit or delete dictionaries and their values. Users select values from a dropdown list; enabling ‘MultiChoice’ in the attribute structure permits more than one selection.

<a id="element-01a1452e-0bdc-75c8-a69b-8a611255817f"></a>

![Create, edit or delete dictionaries and their values. Users select values from a dropdown list; enabling ‘MultiChoice’ in the attribute structure permits more than one selection.](https://docs.mintsd.com/api/reader/assets/assets/images/image529.png?v=428abb599bb3908bf9b2c193a36599857f131405094ad21b8643aad6361d4479)

<a id="element-01a1452e-0bdc-7046-9736-bc96964196a9"></a>

<a id="element-01a1452e-0bdd-7a27-aed6-eca8a2989d8c"></a>

## Creating a dictionary

In order to create a new Dictionary, click the “Add new value”
![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-0bdc-7046-9736-bc96964196a9) button, located on the right side, and the creation screen
will be displayed.

<a id="element-01a1452e-0bdd-7a6d-9b9c-76634fa12b4f"></a>

![In order to create a new Dictionary, click the “Add new value” button, located on the right side, and the creation screen will be displayed.](https://docs.mintsd.com/api/reader/assets/assets/images/image531.png?v=227fffb7c86e11e02dc5840566d76f8d7c41ef370bf2fbaa12ea17c3dd060e48)

<a id="element-01a1452e-0bdd-7330-baa1-075965d83ffa"></a>

Now, type the name for your Dictionary e.g., “Computer Types” and then
select one of the types available on the ‘Select type…’ dropdown list.
In our example, we will choose the “Text” type.

<a id="element-01a1452e-0bde-70ee-9c6b-87434f2d8432"></a>

There are more dictionaries types that you can use: “Char”, “Checkbox”,
“Date”, “Decimal”, “Email”, “Integer”, “Phone number”, “Text” and “Time”.

<a id="element-01a1452e-0bde-7ff6-9fa2-983d2a7cc697"></a>

![There are more dictionaries types that you can use: “Char”, “Checkbox”, “Date”, “Decimal”, “Email”, “Integer”, “Phone number”, “Text” and “Time”.](https://docs.mintsd.com/api/reader/assets/assets/images/image532.png?v=f3b4ded6494baab877cc7d42be3d1d469554f9a2ce2268c32e99d936a4c94781)

<a id="element-01a1452e-0bdf-7a42-aa1f-85507f802d18"></a>

Remember that you can create your types under Fields settings > Regexes.

<a id="element-01a1452e-0bdf-7b3c-b9b8-287c57bdf235"></a>

![Dictionaries: Remember that you can create your types under Fields settings > Regexes.](https://docs.mintsd.com/api/reader/assets/assets/images/image934.png?v=4f497640d52f30ad52ce3c907a336c4115f9f510199a816b16134e0970321fab)

<a id="element-01a1452e-0bdf-7a8d-8c0c-3bcbb2b713b3"></a>

<a id="element-01a1452e-0be0-7ed8-ad1f-84117a0ea060"></a>

Once you to that, click on the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-0bdf-7a8d-8c0c-3bcbb2b713b3) button and you will see that a
view has been expanded and you can add the first value for your
Dictionary.

<a id="element-01a1452e-0be0-792b-9100-500f87501bd8"></a>

![Once you to that, click on the button and you will see that a view has been expanded and you can add the first value for your Dictionary.](https://docs.mintsd.com/api/reader/assets/assets/images/image533.png?v=de812619c280bbea91c220ccbfcb4a105f63267e9b30b925584e9d524fed19ab)

<a id="element-01a1452e-0be1-7858-8573-adc0131d8522"></a>

<a id="element-01a1452e-0be1-78e0-96e9-acfbded9d845"></a>

## Values and child values

By pressing the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-0be1-7858-8573-adc0131d8522) button you can add as many positions for your
values as you want.

<a id="element-01a1452e-0be2-72b3-b5d0-ed563dec6219"></a>

<a id="element-01a1452e-0be2-74ec-a3d4-711c7c1039b3"></a>

Type the name for each value in ‘Value…’ text field and press ‘Enter’ on
your keyboard. You can use a ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image534.png?v=0f3bf9fe391401fa15e6a5d11e127752bb3e7583da3a3a57e9e1854c51f41966#element-01a1452e-0be2-72b3-b5d0-ed563dec6219) button for this as well.

<a id="element-01a1452e-0be2-7549-a33a-2e20f8468762"></a>

<a id="element-01a1452e-0be3-7e9c-87b6-25cf712454ea"></a>

If at any moment, while typing the name, you decide that you want to
remove the whole position just press the ![Remove](https://docs.mintsd.com/api/reader/assets/assets/images/image411.png?v=ccb68b16b46a14ece363ba39c1cc23cb5ce79219ac4d8c86c10d937edfe3126e#element-01a1452e-0be2-7549-a33a-2e20f8468762) button.

<a id="element-01a1452e-0be3-706c-a041-1307a6157637"></a>

<a id="element-01a1452e-0be3-7edb-a057-afe1dae610c3"></a>

<a id="element-01a1452e-0be4-7bd9-aa34-8377ef9cb750"></a>

After you saved the names for the values you can do a couple of things.
You can rename the Value by pressing the ![Edit](https://docs.mintsd.com/api/reader/assets/assets/images/image268.png?v=259d4c67449ac46a74126ce029b86c8fe0cf99fd382518a480e00f283554ecae#element-01a1452e-0be3-706c-a041-1307a6157637) edit button or
delete the Value by pressing the ![Delete](https://docs.mintsd.com/api/reader/assets/assets/images/image228.png?v=b49c174f13ec30cdd023f322f43c60d2f2e16a16d3f207ccbfa119b0906a0fe2#element-01a1452e-0be3-7edb-a057-afe1dae610c3) button.

<a id="element-01a1452e-0be4-7bb7-b019-d605f0604660"></a>

![After you saved the names for the values you can do a couple of things. You can rename the Value by pressing the button edit button or delete the Value by pressing the button.](https://docs.mintsd.com/api/reader/assets/assets/images/image538.png?v=dd60ab1cad2751d9c305f5ac0305b39cfcefd708f47a1776a374e60f834bf608)

<a id="element-01a1452e-0be5-7b3a-a326-08f35473dd44"></a>

<a id="element-01a1452e-0be5-757f-9168-a0ffdff95b71"></a>

What’s more important is that you can create a ‘Child value’ for each
Value. To do that press the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image539.png?v=98260b68be2aa1a74b415a63c48b80fea320726604178c068f096054029d6775#element-01a1452e-0be5-7b3a-a326-08f35473dd44) button on the right side of
Value’s name. A new row will appear right below. You will notice that
its position is not equal to the “parent” Value and it is moved a little
bit to the right.

<a id="element-01a1452e-0be5-7bc3-872a-2d213dbeca08"></a>

![Dictionaries: What’s more important is that you can create a ‘Child value’ for each Value.](https://docs.mintsd.com/api/reader/assets/assets/images/image540.png?v=7191dcbfecf3536cb1841dbbe97e4c688f55194d811c6f92b834c253a098b0da)

<a id="element-01a1452e-0be6-770e-91a2-5fe7aef6adea"></a>

You can add several child values to each parent value.

<a id="element-01a1452e-0be6-792c-9a4a-764ea6fbf27e"></a>

![Dictionaries: You can add several child values to each parent value.](https://docs.mintsd.com/api/reader/assets/assets/images/image541.png?v=473b5e2653e77e8a16430c77a12473dce58713e84a2ea005c795ae8ec389bd44)

<a id="element-01a1452e-0be8-7cad-8428-a59d38592bd9"></a>

<a id="element-01a1452e-0be8-73fd-9891-4c4741de247b"></a>

Once you’re done you can save your Dictionary by clicking on ![Create](https://docs.mintsd.com/api/reader/assets/assets/images/image58.png?v=3659f4ed6ae2729e35fe5eb8832cf827f8c264181610e981304daec839c30f99#element-01a1452e-0be8-7cad-8428-a59d38592bd9)
button to create your new Dictionary.

<a id="element-01a1452e-0be9-7910-9f0d-8885a9cc4761"></a>

Every time you have a dictionary with ‘child values’ you can use some
additional options to help you display them. Once you’re either in
‘Create new dictionary’ or ‘Edit dictionary’ view you can use the Expand
/ Collapse buttons.

<a id="element-01a1452e-0be9-7939-b60a-2c77853b0d48"></a>

![Every time you have a dictionary with ‘child values’ you can use some additional options to help you display them. Once you’re either in ‘Create new dictionary’ or ‘Edit dictionary’ view you can use the Expand / Collapse buttons.](https://docs.mintsd.com/api/reader/assets/assets/images/image543.png?v=6d65a172476260f8b7ee0c014459f86c43b07fc3b19af5ea8c6c4afc7fa02fdb)

<a id="element-01a1452e-0bea-7964-94ab-1b788750426f"></a>

The first one will show everything, including ‘Child values’, while the
second will hide them and you will only see ‘Values’.

<a id="element-01a1452e-0bea-7188-802c-0dee3948ca1f"></a>

<a id="element-01a1452e-0bea-70be-9378-b6bbec3c9652"></a>

<a id="element-01a1452e-0beb-7259-833c-9ff136aef109"></a>

If you don’t want to see ‘Child values” of every Value that has them,
you can expand and see ‘Child values’ of only one specific Value. Just
press the ![Move right](https://docs.mintsd.com/api/reader/assets/assets/images/image544.JPG?v=70a1f4ac49ff3074f81fa876dd31e984e94124f99498b11da853196842790b52#element-01a1452e-0bea-7188-802c-0dee3948ca1f) button in order to expand the list or the
![Move left](https://docs.mintsd.com/api/reader/assets/assets/images/image545.JPG?v=6ecf216378910c8760aff8e3c448067c917194dfcc7064a03970e263761dc6c1#element-01a1452e-0bea-70be-9378-b6bbec3c9652) button to hide it.

<a id="element-01a1452e-0beb-745c-91db-4ecae6ce4e71"></a>

![If you don’t want to see ‘Child values” of every Value that has them, you can expand and see ‘Child values’ of only one specific Value. Just press the button in order to expand the list or the button to hide it.](https://docs.mintsd.com/api/reader/assets/assets/images/image541.png?v=473b5e2653e77e8a16430c77a12473dce58713e84a2ea005c795ae8ec389bd44)

<a id="element-01a1452e-0bec-7582-8ce2-d5ae09200812"></a>

<a id="element-01a1452e-0bec-7d19-acd0-bf4a7823dcf4"></a>

<a id="element-01a1452e-0bec-7d7c-b3a5-437343de7f89"></a>

<a id="element-01a1452e-0bed-7986-ad33-7c28b20dee26"></a>

## Value settings

Let’s take a look at the remaining buttons. The ![Settings](https://docs.mintsd.com/api/reader/assets/assets/images/image1147.png?v=35c7d18d5b272338ff2361a2591dc215942adf89204c88b111b7d2d8b98c9938#element-01a1452e-0bec-7582-8ce2-d5ae09200812) button allows adding
descriptions to each value in the dictionary depending on the configuration
under the ![Description pattern](https://docs.mintsd.com/api/reader/assets/assets/images/image1148.png?v=76f084a43c50f4312871ea70cb2e3fb47aa4525f4dc66eee739bfde10bdba211#element-01a1452e-0bec-7d19-acd0-bf4a7823dcf4) button. For example, we added a dictionary value
named Computer 1, but we want to assign a different label to the name. First we
configure settings under the ![Description pattern](https://docs.mintsd.com/api/reader/assets/assets/images/image1148.png?v=76f084a43c50f4312871ea70cb2e3fb47aa4525f4dc66eee739bfde10bdba211#element-01a1452e-0bec-7d7c-b3a5-437343de7f89) button and save:

<a id="element-01a1452e-0bed-7ac5-bcea-1b294d9d8b2e"></a>

![Dictionaries: Let’s take a look at the remaining buttons.](https://docs.mintsd.com/api/reader/assets/assets/images/image1151.png?v=3bc494336d119f481ec377d08533da52fd4bad9a5dd6fe3e1e80a9222693a05a)

<a id="element-01a1452e-0bed-726e-81c0-e4f65bc5029e"></a>

<a id="element-01a1452e-0bee-7e93-a736-b855549d3828"></a>

Next we click the ![Settings](https://docs.mintsd.com/api/reader/assets/assets/images/image1147.png?v=35c7d18d5b272338ff2361a2591dc215942adf89204c88b111b7d2d8b98c9938#element-01a1452e-0bed-726e-81c0-e4f65bc5029e) button and enter the name that will be displayed in
the ticket for this dictionary entry.

<a id="element-01a1452e-0bee-7a57-9408-ae9189e893c6"></a>

![Next we click the button and enter the name that will be displayed in the ticket for this dictionary entry.](https://docs.mintsd.com/api/reader/assets/assets/images/image1149.png?v=c5855351e1b41571053a335c74eb8738be8b8ce315e35dcfe17d1ddba9b74076)

<a id="element-01a1452e-0bef-7bbb-a958-8d72047797b5"></a>

![Next we click the button and enter the name that will be displayed in the ticket for this dictionary entry.](https://docs.mintsd.com/api/reader/assets/assets/images/image1150.png?v=81ab9d505f0b0ca1004500387a54ae6a90b5c9a42768621d9aa632cd16efd32c)

<a id="element-01a1452e-0bef-7ea7-bb6c-1bcf6ae20e1b"></a>

After saving the changes, the value is assigned. From now on, when selecting a value
from the dictionary, the user (Agent and Client) will see the value with the label.

<a id="element-01a1452e-0bf0-745c-97ec-9caad4812d18"></a>

![After saving the changes, the value is assigned. From now on, when selecting a value from the dictionary, the user (Agent and Client) will see the value with the label.](https://docs.mintsd.com/api/reader/assets/assets/images/image1152.png?v=80e38fae4cc7f06a4039c0caac209e00059b7531e6553d86ca7a331df9f97649)

<a id="element-01a1452e-0bf0-7bbd-8fab-3dfb333fabd8"></a>

<a id="element-01a1452e-0bf1-7afd-b19e-cf5ae1d0c5bf"></a>

<a id="element-01a1452e-0bf1-7cfd-99bf-f526f42da5b8"></a>

## Conditional visibility

The ![Dictionary value visibility](https://docs.mintsd.com/api/reader/assets/assets/images/image1153.png?v=d87a4acbbbdbdb4d4ad29022302f3e0ebc3854e42ecb4bb155d3d5d2d277946a#element-01a1452e-0bf0-7bbd-8fab-3dfb333fabd8) button allows specifying for which set parameters the dictionary
value should be visible in the ticket. After clicking it, a new window opens with
the possibility of adding values on the left, as well as Close and Save buttons on the right.
Click the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-0bf1-7afd-b19e-cf5ae1d0c5bf) button to add a new row.

<a id="element-01a1452e-0bf1-7f7e-a420-9381e44c8dc2"></a>

![The button allows specifying for which set parameters the dictionary value should be visible in the ticket.](https://docs.mintsd.com/api/reader/assets/assets/images/image1155.png?v=6adf7c2caa7d11c0803321d0f9a105c8d3e1b55140bd6845dc71c918ea2a863f)

<a id="element-01a1452e-0bf2-7eef-84b9-e20365e525eb"></a>

Select one of these parameters on the left:

<a id="element-01a1452e-0bf3-70e8-adea-b381a7726cf9"></a>

- Queue
- Ticket Type
- Service
- Priority

<a id="element-01a1452e-0bf4-7fcf-9a77-6cd3bd1b4c44"></a>

Selecting one of the above options allows you to choose a specific value assigned to
this option in the field on the right side of the row, such as a specific queue, ticket
type, priority, or service.

<a id="element-01a1452e-0bf4-7ba7-bc9a-6c27bf2497c0"></a>

For example, select Android in the Operating Systems dictionary.

<a id="element-01a1452e-0bf4-72d3-855f-3bd2ec7e46c7"></a>

![Dictionaries: For example, select Android in the Operating Systems dictionary.](https://docs.mintsd.com/api/reader/assets/assets/images/image1156.png?v=55330c5a80fc72300c7ce328169208df417e0add37a16fdf8bbc5e75b16ddeeb)

<a id="element-01a1452e-0bf5-7f96-99d9-cb8d18a15478"></a>

<a id="element-01a1452e-0bf5-7f6a-b730-8de31e6e64b1"></a>

in ![Dictionary value visibility](https://docs.mintsd.com/api/reader/assets/assets/images/image1153.png?v=d87a4acbbbdbdb4d4ad29022302f3e0ebc3854e42ecb4bb155d3d5d2d277946a#element-01a1452e-0bf5-7f96-99d9-cb8d18a15478) button choose the ticket type: Smartphone Users and save.

<a id="element-01a1452e-0bf6-7c30-8379-ea40f6729a2a"></a>

![Dictionaries: in button choose the ticket type: Smartphone Users and save.](https://docs.mintsd.com/api/reader/assets/assets/images/image1154.png?v=7eb9fa65f09c63b5ed1e035f50254bc5892e4a5b897018bbc0879f1f76c26a70)

<a id="element-01a1452e-0bf6-7094-92b3-7278f93a9f7c"></a>

This means that the given dictionary value will be visible only for the ticket type: Smartphone Users.

<a id="element-01a1452e-0bf7-7b4a-864e-6b4e68e5239a"></a>

When an agent creates a Computer Users ticket, Android is absent from the Operating Systems dictionary used by Select Operating System.

<a id="element-01a1452e-0bf7-72af-beb6-9568c1e18ddb"></a>

![When an agent creates a Computer Users ticket, Android is absent from the Operating Systems dictionary used by Select Operating System.](https://docs.mintsd.com/api/reader/assets/assets/images/image1157.png?v=9058f3c870e2f6b28a01167f0e769676aed099f3ad92bd5d648b8f3bb551ebd1)

<a id="element-01a1452e-0bf8-715a-a43d-4e04c9727552"></a>

When the agent creates a Smartphone Users ticket using the same dictionary, Android is available.

<a id="element-01a1452e-0bf8-7183-907c-10981360edc5"></a>

![When the agent creates a Smartphone Users ticket using the same dictionary, Android is available.](https://docs.mintsd.com/api/reader/assets/assets/images/image1158.png?v=c52d9d299ef72d901bddc0a661808eb4623dd24041edaef546d823f9c3f4a50e)

<a id="element-01a1452e-0bf9-77f8-8e1b-eaf2dc478f59"></a>

Remember, not selecting any parameters under the discussed functionality means that the values should always
be visible (depending on the permissions assigned to the custom field).

<a id="element-01a1452e-0bf9-72c2-b013-44c948520a8b"></a>

We can add more parameters if needed.

<a id="element-01a1452e-0bfa-73fd-9a74-a0be78e89f29"></a>

<a id="element-01a1452e-0bfa-7345-9be7-a7249a97b130"></a>

Now, let’s go back to the main Dictionary list. Whenever you decide to
change anything in any of the dictionaries, just click the ![Edit](https://docs.mintsd.com/api/reader/assets/assets/images/image89.png?v=702adcf46ea452d46f158b0c91e923f5b40ae6f37d95ca5764e20654a2855c4c#element-01a1452e-0bfa-73fd-9a74-a0be78e89f29)
button located on the right side (‘Action’ column) of each dictionary on
the list.

<a id="element-01a1452e-0bfa-7db4-8e5d-1d82dbb6735a"></a>

![Now, let’s go back to the main Dictionary list. Whenever you decide to change anything in any of the dictionaries, just click the button located on the right side (‘Action’ column) of each dictionary on the list.](https://docs.mintsd.com/api/reader/assets/assets/images/image805.jpg?v=198df08c73e2e43a44db5df51514ab5000b9cc1d4bf1f59528faec574097013e)

