Skip to main content

What a .doqlo project file is

Use this page when .doqlo is new to you and you want the basic mental model first.

What A .doqlo Project File Is​

A .doqlo project file is the saved Bulk Fill workflow configuration from Doqlo.

It stores the setup Doqlo needs to reopen or reuse a Bulk Fill workflow later, including field placement, CSV mapping, supported native PDF form mapping, and related project configuration prepared in the editor.

It is not the final exported PDF. It is the saved setup behind that workflow.

How To Think About What It Contains​

For normal product use, the important point is simple: a .doqlo project file saves the reusable parts of a Bulk Fill workflow so you do not have to rebuild them from scratch.

That usually includes:

  • field placement
  • CSV mapping
  • supported native PDF form mapping
  • related project setup needed to reopen or execute the workflow later

How You Use It In The Bulk Fill Web Editor​

In the Bulk Fill editor:

  • Save Project saves the current workflow as a .doqlo project file
  • Open Project loads a saved .doqlo project file back into the editor
  • this saves time because you do not need to re-place fields and remap the workflow by hand each time

This is the simplest way to think about .doqlo in the web app: it is the saved version of the workflow you already prepared.

How The Public API Uses It​

In the Public API, the same saved workflow is used as the execution package.

That is why API docs sometimes call it a package while editor docs call it a project file. It is the same saved workflow, viewed in two different contexts.

In practical terms, an API run needs:

  • the source PDF
  • the .doqlo file
  • the row data you want to fill, usually JSON rows or CSV

The .doqlo file contains the workflow configuration that tells Doqlo how to run that export. The API does not accept raw field placements or mapping definitions directly.

Why It Is Worth Keeping​

Keep your .doqlo files when you expect to:

  • rerun the same workflow later
  • reopen a validated project in the Bulk Fill editor
  • move a validated editor workflow into the Public API
  • avoid rebuilding placement and mapping from scratch

Reuse Across Compatible PDFs​

Doqlo intentionally treats .doqlo as reusable workflow configuration, not as a file that only works with one exact PDF fingerprint.

That means the same .doqlo file can still be useful across the same PDF, a slightly changed PDF, or a related PDF when the layout still makes practical sense.

Read Reuse .doqlo Project Files Across PDFs for the full explanation of that behavior, what still stays strict, and what to review when the PDF changes.