AcroForm

The original interactive form technology in PDF — allows text fields, checkboxes, radio buttons, and dropdowns to be filled by readers.

AcroForm is the original interactive form technology built into the PDF specification. The name comes from Adobe Acrobat, where it was first introduced in PDF 1.2 (1996). An AcroForm turns a static PDF into a fillable document — readers can type into text fields, tick checkboxes, select radio buttons, and pick from dropdown lists without ever printing the page.

Unlike a regular PDF page, which is a fixed canvas of text and images, an AcroForm layer sits on top of the page content as a set of form field annotations. Each field knows its position on the page, its type, its default value, and any validation rules. When a user fills in the form, their values are stored separately from the page content and can be extracted, submitted, or saved.

AcroForm is supported by virtually every PDF viewer in existence — from Adobe Acrobat and Reader to Apple Preview, Google Chrome's built-in viewer, and every major PDF library. This broad compatibility makes it the default choice for any fillable PDF intended for wide distribution.

Field types in an AcroForm

AcroForm supports seven core field types defined in the PDF specification:

**Text field** — A single-line or multi-line input where the user types free text. Text fields can enforce a maximum character length, a specific format (date, phone number, ZIP code), and a font for display.

**Checkbox** — A boolean toggle. Multiple checkboxes on a page can be independent or grouped. A checkbox exports a name/value pair when checked and nothing when unchecked.

**Radio button** — A group of mutually exclusive options. Clicking one radio button in a group deselects all others. Radio buttons in the same group share a field name; each option has a distinct export value.

**List box** — A scrollable list from which the user can select one or multiple items. The available options are stored in the field's /Opt array.

**Combo box (dropdown)** — A collapsed list that expands on click. Unlike a list box, it can optionally allow the user to type a custom value not in the list.

**Push button** — A clickable button that triggers a JavaScript action, submits the form, resets all fields, or opens a URL. Push buttons have no persistent value.

**Signature field** — A placeholder for a digital or graphical signature. When signed with a digital certificate, the field contains a cryptographic signature that can verify document integrity.

How AcroForm data is stored

Field values in an AcroForm are stored in the PDF's object graph under the document's /AcroForm dictionary. Each field is a PDF annotation object of subtype /Widget. The /Widget annotation defines the visual appearance of the field (its rectangle, border, background, and font) while the field dictionary defines its data properties (name, type, value, and flags).

When you save a filled AcroForm PDF, the current values are written back into the field dictionaries. This means the data travels with the file — you can share the filled PDF and the recipient will see your values without needing a separate data file.

Alternatively, form data can be extracted and submitted independently. AcroForm supports three submission formats: FDF (Forms Data Format), XFDF (XML Forms Data Format), and HTML form submission. These allow a server to receive just the field name/value pairs rather than the entire PDF, which is useful for backend processing.

AcroForm versus XFA Form

PDF contains two entirely separate form technologies. AcroForm (described here) is the original and is defined in the core PDF specification. XFA (XML Forms Architecture) is a later addition, introduced by JetForm Corporation and later acquired by Adobe, that embeds an XML-based form description inside the PDF.

XFA forms are dynamically laid out — the form can add or remove pages based on the data entered, and fields can reflow like a web page. This power comes at a cost: XFA is only fully supported by Adobe Acrobat and a handful of specialist viewers. Chrome, Firefox, Apple Preview, and most PDF libraries do not render XFA forms at all.

For this reason, XFA has been officially deprecated in PDF 2.0. Adobe itself recommends converting XFA forms to AcroForms. For any form intended to work on the widest range of devices, AcroForm is the right choice.

Flattening a filled AcroForm

Once a user has filled in an AcroForm, you may want to "flatten" it — merging the field values permanently into the page content so they can no longer be edited. Flattening is useful when:

- You need to send a finalised document where the values cannot be changed - You are archiving the form in PDF/A format, which does not allow interactive fields - You want the values to be visible in viewers that do not support form rendering

After flattening, the form fields no longer exist as interactive objects. The text the user typed appears as ordinary text drawn on the page, and checkboxes appear as static marks. The PDF behaves like a normal non-interactive document. PDFTheGuide's fill-form tool lets you fill and download AcroForm fields; the downloaded PDF embeds your values directly into the page.

Frequently asked questions

What is an AcroForm in a PDF?

An AcroForm is the built-in interactive form system in the PDF specification. It adds fillable fields — text inputs, checkboxes, radio buttons, dropdowns, and signature placeholders — on top of a PDF page. Readers can fill the form in any standard PDF viewer without printing.

What is the difference between AcroForm and XFA?

AcroForm is part of the core PDF specification and is supported by every PDF viewer. XFA (XML Forms Architecture) is a separate, XML-based form format embedded inside some PDFs, created by Adobe. XFA is only fully rendered by Adobe Acrobat/Reader and has been deprecated in PDF 2.0. For maximum compatibility, use AcroForm.

Can I fill an AcroForm without Adobe Acrobat?

Yes. AcroForm fields are supported by Apple Preview, Google Chrome's PDF viewer, Firefox, and most dedicated PDF tools including PDFTheGuide. You do not need Adobe Acrobat to fill standard AcroForm fields.

What happens when I flatten an AcroForm?

Flattening merges the filled field values permanently into the page as static content. The fields are no longer interactive — the text and check marks become part of the page itself. This is useful for archiving or sharing a finalised document that should not be re-edited.

Can AcroForms submit data to a server?

Yes. An AcroForm can include a submit button that sends field data to a URL in FDF, XFDF, or HTML form format. This lets servers receive just the name/value pairs without the full PDF — useful for data collection workflows.

Are AcroForm fields saved when I download the PDF?

Yes. When you fill a form and save or download the PDF, your values are written into the field dictionaries in the file. Anyone who opens the downloaded PDF will see your filled values.