> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/user/template-builder/template-dynamic-fields/qr-barcode-field.md).

# QR/barcode Field

Use **QR/barcode field** to generate QR codes and barcodes.

You can place this field in:

* structured documents
* PDF documents

### Add a QR/barcode field

{% columns %}
{% column %}

1. Open the template in edit mode.
2. In the **Fields** panel find the **QR/barcode field** and add it to the template.
3. Configure the field and click **Save**.
   {% endcolumn %}

{% column %}

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

### Field settings

Click on the placed field to reopen settings menu.

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

* **Name** — field name shown in the document
* **Role name** — role that fills the field (only for manual content)
* **Placeholder** — hint text shown before input
* **Tooltip** — additional hint shown on hover
* **Code type** — QR/barcode type
* **Code content** — what is encoded in the code
* **Width** — code width (default value depends on **Code type**)
* **Width units** — millimetres or percentage of document width
* **Optional** — whether filling the field is required (available for manual content)
  {% endcolumn %}

{% column width="41.666666666666664%" %}

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

{% hint style="warning" %}
Most 1D barcodes support a limited set of characters.

Because of this, **Envelope URL** code content may be unavailable for 1D types.
{% endhint %}