> For the complete documentation index, see [llms.txt](https://developers.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.docstudio.com/api-documentation/template-api/template-dynamic-fields-api/dropdown-field-api.md). # Dropdown Field API Use this page to add a dropdown field to template XML. Assign the field to a role with `roleId`, then reuse the same field `name` in envelope requests. ### Dropdown field example ```xml ``` ### Required attributes * `type` — field type. Use `dropdown`. * `name` — field name. Use 1 to 128 characters. Do not use `&`, `"`, `<`, or `>`. Keep the value unique within one document. * `roleId` — role identifier for the recipient who fills the field. ### Optional attributes * `placeholder` — placeholder text shown in the template and envelope. Use 0 to 1024 characters. If you omit it, the envelope shows the field name. * `optional` — set to `true` if the recipient can leave the field empty. If you omit it, the default value is `false`. * `allowCustomValue` — set to `true` if the recipient can enter a custom value. * `multiSelect` — set to `true` if the recipient can select more than one option. * `search` — set to `true` if the field value should be available in envelope search. If you omit it, the default value is `false`. ### Option rules * Add options as nested `