Skip to main content

Prepare your PDF

Use this page before you place fields or upload CSV data. A clean fillable PDF form or stable PDF layout saves time later because Bulk Fill depends on stable positions, readable layouts, enough room for variable text, and a clear choice between native PDF form fields and overlays.

What Bulk Fill Needs From Your PDF​

Bulk Fill works best when the PDF has clear, repeatable areas for the values you want to place. Before you upload, confirm that:

  • the same content should appear in the same position on every output
  • the target areas are visually clear
  • each field has enough room for realistic values
  • the layout does not rely on manual per-row layout changes

Good PDF Form Or Layout Characteristics​

Prefer PDFs with:

  • simple, stable page structure
  • obvious label-and-value areas
  • enough white space for longer names, dates, amounts, or notes
  • consistent page count and layout from one export run to the next

If Your PDF Already Contains Fillable Form Fields​

Some existing PDF forms already include native fillable form fields. When those fields are supported non-XFA AcroForm fields, native form fill is often the preferred path for structured business documents.

Use the native path when:

  • the PDF already contains the text fields, checkboxes, dropdowns, or radio groups you need
  • you want to use the PDF's own form structure instead of placing everything as overlays

Keep using overlays when:

  • the PDF does not contain the native fields you need
  • you need extra text, QR codes, or barcodes in positions the original form does not provide
  • the PDF is XFA or otherwise outside the supported native form scope

If your PDF already has supported native fields, continue to Work with native PDF forms (AcroForm).

Common PDF Problems​

Password-protected PDFs​

If Bulk Fill reports that the PDF requires a password, automatic compatibility conversion cannot continue. Remove the password first, or create an unlocked PDF copy in a trusted desktop application, then select that copy as a new file.

This is different from a permission-restricted PDF that opens without asking for a password. A viewer may display that file while its document permissions still make editing and export unsafe. Bulk Fill offers the compatible-copy workflow for eligible permission-restricted files instead of treating them as password-required.

Incompatible PDFs​

Some static XFA, permission-restricted, or otherwise incompatible PDFs can be turned into a flat, unencrypted compatible copy. When Bulk Fill offers this option, it does not open or save the selected file as a draft before you confirm.

Choose Create and continue to send that selected PDF through Doqlo's authenticated, temporary compatibility-conversion service. Doqlo validates the returned copy before opening it. The original file is not changed, and only the validated compatible copy becomes the working PDF saved by the normal local draft flow.

Doqlo attempts to preserve the visible page layout. Some PDFs may render differently after conversion, and interactive controls may be flattened, changed, or removed. Review every page before mapping or export. The compatible copy is intended for the existing overlay workflow, not native XFA editing. Select Download the compatible PDF before continuing if you need the same compatible copy in another application or as Public API input.

Ordinary supported PDFs stay in the browser and do not use compatibility conversion. If you cancel, conversion fails, or the returned PDF does not pass validation, the candidate is not opened or saved as a draft.

Dynamic XFA and password-required documents are not eligible for automatic conversion. Follow the manual instructions shown by Bulk Fill, then select the new PDF copy as a fresh file.

If an older local draft reports that its encrypted original cannot be exported safely:

  1. Choose Save Project to download the .doqlo project.
  2. Reopen the original PDF as a new file.
  3. Choose Create and continue when Bulk Fill offers a compatible copy.
  4. Choose Open Project and select the saved .doqlo file to restore the fields and mappings.
  5. Load the CSV you want to use. Current project files do not contain CSV data or its filename.

The failed export does not delete the existing local draft. The Public API does not create compatible copies, so use the downloaded compatible PDF as the API pdf input.

Reuse a changed working PDF​

After successful compatibility conversion, the compatible PDF becomes Bulk Fill's working PDF. Saved page organization can change that working PDF again by deleting, moving, or rotating pages.

When either change applies, the Batch Export modal shows Download current PDF. Use it when you need the same converted or organized PDF as a new web workflow or Public API input. This download is independent from Export batch, which continues to produce only the filled batch output.

The current-PDF download does not include overlays, CSV values, mappings, or other finalized batch additions. If page organization changed the PDF, do not pair the downloaded PDF with the current .doqlo. Save the latest .doqlo separately to preserve the existing Bulk Fill project.

Files That Are Too Large​

Very large PDFs may hit upload limits. If that happens, compress the file or simplify the document before uploading again. Check Plans & Limits if you need current size boundaries.

Layouts That Leave No Room For Variation​

If a field barely fits the shortest sample value, the longer rows in your CSV will probably overflow. Leave extra room for real data, not just ideal data.

Practical PDF Preparation Checklist​

Before you start mapping, review these points:

  1. Open the PDF and identify each area that will change by row.
  2. Decide whether the document is better served by overlays, supported native form fields, or a mix of both.
  3. Confirm that longer values still have room to fit.
  4. Remove password protection or other editing blockers.
  5. Re-save the file if the PDF has a history of compatibility issues.
  6. Upload the PDF and preview at least a few rows before you trust the batch output.

Next Steps​