# How to Create and Manage Dictionaries

### **Permissions**

{% hint style="warning" %}
This functionality is blocked if you don't have the Dictionary editing permission.
{% endhint %}

Dictionary manager allows :

{% columns %}
{% column width="41.66666666666667%" %}

* creating new dictionaries
* adding columns
* changing columns' order
* editing columns
* deletion of records
  {% endcolumn %}

{% column width="58.33333333333333%" %}

* changing the name
* description and access level of dictionaries
* deletion of dictionaries
* creation of records and the changing of values in records
  {% endcolumn %}
  {% endcolumns %}

### **Create Dictionary**

<figure><img src="/files/PsIOLfhhDD7tbaUkptgX" alt=""><figcaption></figcaption></figure>

1. Navigate to **Dictionary** on the sidebar menu.
2. Click the <img src="/files/lCQb0MJ4W3ahhwJUO5mw" alt="" data-size="line"> button.

### Dictionary functionality

<figure><img src="/files/Zrul3C6i42S26raJ441a" alt=""><figcaption></figcaption></figure>

After you create a dictionary, you can configure its properties, manage rows, and manage columns.

1. **Name**: Default is New dictionary. Max **128** characters.
2. **Description**: Optional. Max **256** characters.
3. **Allow filtered access**: Controls what values are available in an envelope’s dictionary field.
   * **Off**: Any value from the selected column can be chosen.
   * **On**: Only values from rows matching other field values are returned.
4. **Access level** (default: **Mailbox**): Controls which mailboxes can use the dictionary.
   * **Mailbox**: Visible only to the current mailbox. Only that mailbox can select records.
   * **Account**: Visible to all mailboxes in the same account.
   * **Public**: Visible to all mailboxes.

{% columns %}
{% column %}
5\) Click **Add column** to add a new column.\
**Optional** — Enable the **Extended Character limit** toggle to increase the characters limit to 5000.

{% hint style="warning" %}
When enabled, this column can only be used in **Lookup fields** and unavailable for **Dictionary fields**.
{% endhint %}
{% endcolumn %}

{% column %}

<figure><img src="/files/ukVKigJ9qsUtLmXZu9vB" alt="" width="366"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

6. Click **Add row** to add a new row (record).\
   — Select rows using the checkbox. When at least one row is selected, **Delete rows** appears.
7. **Import**: Allows you to upload a dictionary from your computer.
8. **Export**: Starts an export, as soon as it's done you will receive download link to your e-mail.

<p align="center"><img src="/files/cC72Go3PZ0xR8axoSO10" alt=""><br></p>

{% hint style="info" %}
If a column is less than **300 px** wide, these options collapse into a single dropdown menu.
{% endhint %}

Hover the column header to open column edit options:

* Copy column UUID
* Filter
* Rename
* Delete

![](https://ucarecdn.com/ca6e0b96-868d-4f40-989d-dddea5e34092/image.png)

To delete a **dictionary**, click the **Delete**  <img src="/files/NmEksQIdurRw2EZZOu5x" alt="" data-size="line"> icon next to it on the dictionaries list page. Then confirm.

#### Dictionary field behavior after deleting a dictionary or column

**Template**

After deleting a dictionary or a dictionary column, the template becomes invalid. Select a new dictionary/column in the dictionary field properties.

**Envelope**

After deleting a dictionary or a dictionary column, the dictionary field is disabled during processing. The envelope is automatically destroyed after the expiration date.

{% hint style="warning" %}
Exception:\
If **custom values** are allowed, the dictionary field behaves like a text field. You can enter a custom value.
{% endhint %}

Drag the **Column** ![](/files/uFJIHMxCefuBxgbHwSEB) icon to reorder columns. The same order is used when creating dictionary fields.

![](https://ucarecdn.com/e4c53c5e-60dc-4dc0-8624-abb71118bf6a/image.png)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.docstudio.com/user/dictionaries/how-to-create-and-manage-dictionaries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
