Document history and downloads
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 |
| 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
- Troubleshooting - fix a failed document.
- Plans and pricing - allowance and retention.
- Developer API and MCP - read the history from code.
