Auto Fill PDF Forms from JSON or CSV

Auto filling a PDF form is useful when the same structured information must be placed into many standard forms. Instead of typing each value manually, you can upload a fillable AcroForm PDF and a JSON or CSV record. PDF-File.com matches each record key to the exact PDF field name, validates the value, and returns an interactive completed PDF.

Exact field-name matching

PDF Auto Fill is deliberately deterministic. A JSON property or CSV field_name is matched to the PDF field's actual internal name, not its nearby label or visual position. This makes the workflow predictable for repeat processing and prevents a value from being silently inserted into the wrong field.

If a mapping contains a field name that does not exist, processing stops with a clear error. Fields that are not included in the record are left unchanged. The tool does not guess, rename, use fuzzy matching, or infer a destination from natural language.

JSON and CSV formats

JSON object

A JSON mapping is one object whose keys are the PDF field names. Text fields use strings, checkboxes use true or false, and option lists use arrays of strings. For example, a record can contain {"full_name":"Ada Lovelace","agree_terms":true,"country":"CA","interests":["tech","art"]}.

One-record CSV

The CSV format is intentionally small and clear. It contains a header row named field_name,value and one data row. Use one file per record. Checkbox values are true or false; list selections can be separated with semicolons. Quoted commas in values are supported.

Supported AcroForm field types

Text fields accept strings. Checkboxes accept booleans. Dropdowns and radio groups accept one exact option from the options defined by the PDF. Option lists accept an array containing one or more exact available options. Every option is validated before the PDF is saved.

The output remains an AcroForm. Field names, widgets, page count, and page dimensions are preserved, and supported appearances are regenerated so values are visible in common PDF viewers. The form is not flattened, so it remains editable.

Limits and privacy

This tool handles standard AcroForm PDFs only. It does not fill scanned or flat PDFs, XFA forms, digital signatures, arbitrary annotations, or JavaScript actions. It also does not use OCR or an external AI service. Processing is self-hosted through pdf-lib and the normal temporary-file cleanup flow.

For reliable automation, inspect a template's field names once, keep the record keys unchanged, and validate your template with a real PDF viewer. Exact names and exact options are the contract. If a template changes, update the record mapping rather than relying on a guess.

Frequently Asked Questions about PDF Auto Fill

Can I fill a PDF form from JSON?

Yes. Upload a standard AcroForm PDF and a JSON object whose keys exactly match the PDF field names.

Can I fill a PDF form from CSV?

Yes. Use a two-column CSV with field_name and value headers and one data record.

Does auto fill support XFA or scanned PDFs?

No. The tool supports standard AcroForm fields and does not perform OCR or XFA processing.

Will my completed form remain editable?

Yes. The output is not flattened and retains its interactive form fields.

What happens when a field name or option is wrong?

Processing fails with a validation error instead of guessing or placing the value elsewhere.