Skip to content

How to Fill PDF Forms from Excel

Step-by-step guide to bulk-filling PDF form fields with data from Excel or CSV. Upload, auto-map columns, and generate completed documents.

Complete Guide: Filling PDF Forms from Excel

If you have a PDF with form fields and an Excel spreadsheet with data, Mergram can fill in every form automatically — no manual entry needed. This guide walks you through the entire process, from preparing your files to generating completed documents at scale.

Prerequisites

Before you begin, make sure you have:

Not sure if your PDF has form fields?

Open your PDF in Adobe Acrobat Reader and look for highlighted interactive areas. If you can type into fields or check boxes, your PDF has form fields ready for auto-filling.

Understanding PDF Form Fields

PDF form fields (also called AcroForm fields) are interactive areas in a PDF that accept user input. Common types include:

Field TypeDescriptionExample Use
Text fieldsFree-form text inputName, address, phone, dates
CheckboxesYes/no toggle options”I agree to terms”
Radio buttonsSingle-choice selectionsPayment method: credit / debit / PayPal
DropdownsPre-defined option listsState, country, department

Each field has a name (its identifier) and a value (the data that fills it). Mergram reads these field names and matches them to your spreadsheet columns.

Preparing Your Spreadsheet

Your spreadsheet should follow these guidelines:

  1. Column headers should match field names (or be similar for fuzzy matching)
  2. One row per document — each row generates one completed PDF
  3. Consistent formatting — dates as dates, numbers as numbers
  4. No merged cells — keep the structure simple and tabular

Example data table:

NameEmailDateAmountDepartment
John Smithjohn@example.com2025-01-15$150.00Engineering
Jane Doejane@example.com2025-01-15$200.00Marketing
Bob Garciabob@example.com2025-01-16$175.00Sales

Data formatting tips

For best results, avoid special characters in column headers, trim leading/trailing whitespace from your data, and remove any empty rows at the bottom of your sheet. These small steps prevent mapping errors.

Auto-Mapping: How Mergram Connects Columns to Fields

Mergram uses fuzzy matching to connect spreadsheet columns to PDF form fields. This means the names don’t need to be identical — similar names are matched automatically:

After auto-mapping, you can review every mapping and adjust any that aren’t correct. Fields that couldn’t be auto-mapped are highlighted for manual assignment.

When to Use PDF Form Filling

This approach is ideal when you have a pre-existing PDF form with defined fields. Common scenarios include:

If your PDF doesn’t have form fields, you can still place data fields visually using the canvas editor — see the mail merge with Google Sheets guide for that approach.

Best Practices for Reliable Merging

  1. Name fields clearly in your PDF editor — use descriptive names like client_first_name instead of field1
  2. Test with 2–3 rows before running the full dataset to catch mapping issues early
  3. Use the preview to verify each field renders correctly with real data
  4. Check date formats — ensure your spreadsheet dates match what the form expects
  5. Validate required fields — make sure no critical columns have empty values

Common Issues and Troubleshooting

Fields not detected: Your PDF may use XFA forms (dynamic XML forms) instead of AcroForm fields. Try re-saving the PDF in Adobe Acrobat as a “standard” PDF with AcroForm fields.

Wrong data in fields: Check that your column mappings are correct. Fuzzy matching sometimes pairs similar-but-different column names. Unlink and re-map the field manually.

Special characters appearing incorrectly: Save your CSV file with UTF-8 encoding to preserve accented characters, CJK text, and other Unicode content.

Large file processing slowly: For spreadsheets with thousands of rows, the merge runs server-side as a background job. You can close the browser and check back — progress is tracked in the Jobs panel.

XFA forms are not supported

PDF forms based on XFA (XML Forms Architecture) are not compatible with Mergram’s form detection. Most modern PDFs use AcroForm fields, which are fully supported. If you’re unsure, try uploading your PDF — the editor will detect all available fields automatically.

Get Started

Upload your PDF form and Excel file to Mergram’s editor to start filling forms automatically. The free plan lets you test with small batches — upgrade when you’re ready to process at scale.

Step-by-step guide

  1. 1

    Prepare Your PDF

    Create a PDF with form fields using Adobe Acrobat, LibreOffice, or any form builder. Make sure each field has a unique name.

  2. 2

    Prepare Your Spreadsheet

    Create an Excel or CSV file. Column headers should match or be similar to your PDF form field names for auto-mapping.

  3. 3

    Upload to Mergram

    Upload your PDF and spreadsheet to Mergram. The editor will auto-detect form fields and suggest column mappings.

  4. 4

    Map Fields

    Review the auto-mapped fields. Adjust any mappings manually if needed. Use fuzzy matching to connect similar names.

  5. 5

    Generate

    Click merge to generate a completed PDF for each row. Download individually or as a combined file.

Frequently asked questions

What types of PDF form fields are supported?
Mergram supports text fields, checkboxes, radio buttons, and dropdowns defined in AcroForm-compatible PDFs. Digital signature fields are not currently supported. Any standard PDF form created with Adobe Acrobat, LibreOffice, or similar tools will work.
Does it work with PDFs created in Adobe Acrobat?
Yes, Mergram is fully compatible with PDFs created in Adobe Acrobat, Foxit, and any tool that generates standard AcroForm fields. The form fields are detected automatically on upload.
Can I fill PDF forms from a CSV file instead of Excel?
Absolutely. Mergram accepts both Excel (.xlsx, .xls) and CSV (.csv) files. The process is identical — upload your file, map columns to fields, and generate. CSV files are ideal for data exported from databases or CRM systems.
What happens if my column headers don't exactly match the field names?
Mergram uses fuzzy matching to connect similar names. For example, 'ClientName' will auto-map to 'Client Name' and 'client_name'. You can also adjust any mapping manually after the auto-detection step.
Is there a limit to how many PDF forms I can fill at once?
You can process up to 100,000 rows in a single merge job. For large batches, the processing runs server-side in the background, and you can track progress in real time from the Jobs panel.

Ready to try it yourself?

Start merging PDFs in minutes — free account required, no credit card needed.

Related articles