Documents & usageDocument history and downloads

Document history and downloads

Copy page

Find every generated document with its status, source and size, create one by hand from a template, download stored PDFs again, and see how long PDFs are kept on your plan.

Every document that a workflow, the API or you generate is listed on the Documents page, successful or not. It is the first place to look when you want a PDF again or when a workflow did not do what you expected.

The list

Column What it shows
For The order number, product title or customer name the document is about. A failed document shows its error message here
Status Generated, Failed or In progress
Template The name of the template at the time
Source How it was made: Shopify Flow, API, Manual or Test (see below)
Size The size of the PDF
Created When it was generated
PDF A download button while the PDF is stored

Previews in the editor are not listed. They are not documents and do not count toward your plan.

Where a document comes from

The Source badge tells automated and hand-made documents apart:

Source What it means Counts toward your plan
Shopify Flow The Generate document action in a workflow Yes
API The Developer API or the MCP server Yes
Manual You created it in the app, for a real order, product or customer No
Test You created it in the app with sample data No

Test documents are also left out of the figures on the Home page.

Create a document in the app

When a customer asks for an invoice right now, you do not need a workflow. Open the template and select Create document at the top of the editor. Choose what the document is for:

  • Latest order (or product or customer, depending on what the template renders).
  • A specific order: enter the order number, the product title or the customer's email or name.
  • Sample data (test document): made-up values, to check the template.

The document is made from the saved template (save or discard your changes first), added to this history and downloaded as soon as it is ready.

Find a document

  • Search by order, product, customer, template or file name.
  • Filter by template with All templates, by status with All statuses, by source with All sources and by date with Period.

From a template, the Documents button at the top of the editor opens the history filtered to that template. The number in the Documents column of the Templates list does the same.

Download a PDF

Select the download button in the PDF column. The PDF downloads with its file name.

This works for as long as the PDF is stored, also after the 7-day link that Flow received has expired. So when a customer asks for an invoice again after a week, download it here, or create a new one.

How long PDFs are kept

Each plan keeps the PDF files for a number of days:

Plan PDFs kept for
Free 7 days
Starter 30 days
Unlimited 90 days

See Plans and pricing.

After that time the PDF file is deleted. The row stays in the history with its status, template and date, and the PDF column shows Deleted after retention. The document still counts as generated, and nothing changes in your usage.

If you need a document for longer than your plan keeps it, save the PDF in your own system when it is generated, for example by passing the download link to a workflow step that stores the file.

Failed documents

A failed document shows its error in the For column, in the same words Flow shows in its run details. Failed documents do not count toward your plan.

The Home page lists Recent failures and shows your Success rate for the period you pick. You can also get an email when an unusual share of documents from Flow fail, under Notification settings on the Home page.

See Troubleshooting for what each error means.

Next steps