How to Add a Dropdown (Combo Box) to a PDF Form

Dropdowns, what the PDF spec calls combo boxes, are the right field type when you need users to pick one option from a long list. Countries, US states, departments, product categories, severity levels. Showing all options as radio buttons would clutter the page; a dropdown keeps the form compact while constraining input to known values. This guide walks through how to add a dropdown to a PDF form cleanly.

When to use a dropdown vs other field types

For more on the broader catalog, see PDF form field types explained. Quick decision rule:

• 2-5 options: Radio buttons. The user sees all options at once.
• 6+ options: Dropdown. The user clicks to see the list.
• Many options where users might type: Combo box (editable dropdown). Users can either pick from the list or type a value.
• Multiple selection allowed: List box, not a dropdown.

A dropdown is also right when the options change rarely (you can hard-code them into the form) but are long enough that radio buttons get unwieldy.

Tools that add dropdowns

Adobe Acrobat Pro. Tools → Prepare Form → Add Field → Combo Box (or click the dropdown icon in the form toolbar). Click and drag on the page to place the field.

Foxit PDF Editor. Form → Combo Box. Similar UX.

PDF-XChange Editor. Form → Add Combo Box.

LibreOffice Writer. Insert → Form → Combo Box. Re-export as PDF.

Programmatic. PDFKit (Node.js), iText (Java), pikepdf (Python with low-level form manipulation), and PDFlib all support adding form fields including combo boxes.

Browser-based. Docento.app supports adding dropdown fields without installing anything.

Step-by-step in Acrobat Pro

A typical workflow:

1. Open the PDF.
2. Tools → Prepare Form. Acrobat auto-detects existing form fields and offers to add more.
3. In the toolbar, click the Combo Box icon.
4. Click and drag where the dropdown should appear.
5. Properties dialog opens automatically (or right-click → Properties to open).
6. General tab: set the field name (country, department, etc., no spaces).
7. Options tab: add the list items. Each item has an export value (what gets stored when selected) and a display value (what the user sees). Often these are the same; for shorter codes you might display "United States" and export "US".
8. Format tab: usually "None". Use this only for advanced cases.
9. Validate tab: optional validation script for advanced cases.
10. Click Close.
11. Test by filling the form.

For a long list of options (e.g., all 50 US states), you can paste them in bulk:

• Acrobat's Options tab: type or paste items one per line in the "Item:" field, click Add
• Programmatically: pass the array of items at field creation

Export values vs display values

The export value is what gets stored when the form is submitted or its data is extracted. The display value is what the user sees.

For lists where the values are obvious (countries, sizes), use the same value for both:

• Display: "United States" → Export: "United States"

For lists where you want shorter codes downstream (database keys, API values), differentiate:

• Display: "United States" → Export: "US"
• Display: "United Kingdom" → Export: "GB"

This matters for data extraction (see how to export PDF form data), clean export values make the downstream consumer's life easier.

Editable vs non-editable dropdowns

A combo box can be:

• Non-editable, user must pick from the list (a true dropdown)
• Editable, user can type a value not in the list

In Acrobat Pro's Options tab, check "Allow user to enter custom text" for editable. Use editable when:

• The list covers the common cases but unusual values are possible
• "Other" is a legitimate option
• The dropdown is more of a suggestion than a constraint

Use non-editable when the data must match a known set. For a "country" dropdown, non-editable prevents users from typing "USA" vs "United States" vs "U.S.A." inconsistently.

Sorting and default selection

Options:

• Sort items alphabetically, common for countries and states
• Sort by frequency, common for "most-used first" lists
• Custom order, for severity levels (Low, Medium, High, Critical), priority levels, time slots

Acrobat's "Sort items" option toggles alphabetical sorting. For custom order, leave sorting off and add items in the desired order.

Default selection. The Options tab lets you choose a default. Common patterns:

• No default, the dropdown shows blank or "Select..." until the user clicks
• Most common option, pre-selected to reduce clicks
• A placeholder option, "Please select..." as the first item with a special export value

For forms that consume the data downstream, a "no selection" state should be distinguishable from a deliberate selection.

Appearance

Standard appearance properties apply to dropdowns:

• Border, usually a thin line to make the field visible
• Background color, usually white or transparent
• Font, match the form's overall typeface
• Font size, match other fields
• Alignment, left for most text, center or right for specific cases

For accessibility, the field must have a visible label nearby (the dropdown alone is not self-describing) and a tooltip set in Properties → General → Tooltip.

Required dropdowns

To make the dropdown required:

1. Properties → General → check "Required"
2. The form's Submit button can refuse submission if any required fields are empty
3. Many readers visually flag empty required fields after a submit attempt

For more on validation, see how to add validation to a PDF form.

Hierarchical dropdowns

A common need: a "country" dropdown determines what shows in a "state/province" dropdown. This requires JavaScript:

1. On the country dropdown's On Change event, run JavaScript that updates the state dropdown's options based on the selected country
2. Use this.getField("state").setItems(arrayOfOptions) in Acrobat's JavaScript API

JavaScript portability is limited, browser viewers and mobile readers handle it inconsistently. For high-stakes hierarchical forms, the safer pattern is either:

• Generate the PDF dynamically server-side with the right options based on prior input, or
• Use a web form instead of a PDF form for any cascading dropdown logic

Common gotchas

The dropdown appears empty. The Options list was not saved. Re-open the field properties, add the items, click Close.

Dropdown items have surprising characters. Pasting from Word can introduce smart quotes (" vs "), em dashes, or non-breaking spaces. Validate the list visually.

Field name conflicts. Two dropdowns with the same name behave as the same field, both show the same selected value. Use distinct names.

Export value contains commas. Some downstream tools split exported CSV on commas. Avoid commas in export values, or use a different export format.

Dropdown does not work in browser viewer. Some browsers' built-in PDF viewers handle form fields imperfectly. Test in the readers your audience uses.

Mobile dropdowns are tiny. On phones, default-sized dropdowns are hard to tap. Increase the field height and use larger font for mobile-friendly forms.

Print rendering. A long dropdown selection may be truncated when printed if the printed field is narrower than expected. Size the field to fit the longest expected value.

Tab order. When you add fields after the form is partially built, they go to the end of the tab order. Adjust tab order so the user moves through fields in visual reading order.

Practical recipe

To add a "Department" dropdown to an existing PDF form:

1. Open in Acrobat Pro / Foxit / Docento.app
2. Switch to Form Editing mode (Tools → Prepare Form)
3. Click the Combo Box tool
4. Click where the dropdown should appear; drag to size
5. Properties → General → Name: department, Tooltip: "Department"
6. Properties → Options → Items: paste the list (Engineering, Marketing, Sales, Finance, Operations, HR)
7. Set "Sort items" if alphabetical
8. Close Properties
9. Test by clicking the dropdown and selecting a value
10. Save the form

Bulk operations: many dropdowns from a data source

If you need dropdowns populated from an external list (e.g., your team roster updates regularly), generate the form programmatically rather than maintaining it manually:

# Pseudocode
options = load_team_roster()
form_template.add_combobox(name="assignee", items=options)
form_template.save("form.pdf")

PDFKit, iText, and pikepdf-based pipelines handle this. The form template stays static; the populated list updates each time you regenerate.

Takeaway

Dropdowns (combo boxes) are the right tool for "pick one from many" inputs in PDF forms. Acrobat Pro, Foxit, and Docento.app all add them in a few clicks. Define export values and display values deliberately, set a sensible default, and use non-editable mode when the data must match a constrained set. For cascading logic and dynamic options, JavaScript works but has portability limits, prefer dynamically-generated PDFs or web forms for complex behavior. For more on the broader form workflow, see PDF form field types explained and how to create a fillable PDF form.