Troubleshooting

The template uses a filter that does not exist here. Filters from Shopify themes, such as theme money or image filters, are not available. Use the filters listed in Template variables and Liquid: money, percent, br, raw and the standard Liquid filters.

The tags render, include, layout and block are not supported. A template is one HTML file without includes. Copy the shared part into each template instead.

A tag is not closed or is misspelled, for example a for without endfor or an if without endif. Go to the line in the message and check the tags around it.

The template does too much work, usually a loop inside a loop over long lists. Simplify the loops.

A very large loop, list or text. Reduce what the template builds up in variables.

The HTML is too long. Images pasted into the HTML as data are the usual cause: host the image and reference it by URL instead.

A variable that does not exist prints nothing, without an error. Check the spelling against the Variables card in the editor: names use underscores, for example order.total_price, order.shipping_address.zip and line.variant_title. Also check that the template renders the right thing: an order template has no product object.

Not every order has every value: an order without a shipping address, a line item without a SKU, a customer without a phone number. Wrap optional parts in an if, so the label is only printed when the value exists.

Amounts are numbers. Add the money filter to format them with the currency, and percent for a tax rate.

Output is escaped. For a value that is HTML, such as product.description_html, add the raw filter. For a text with several lines, such as brand.address, add the br filter.

Images need an absolute URL that is reachable from the internet, starting with https. A relative path or an image on a private network cannot be loaded. A product or line item without an image has an empty image_url: check it with if first.

A Google font is downloaded when the PDF is rendered. If the download fails, a built-in font is used instead. Upload the font file as a custom font in Settings to make it independent of Google. Also check whether the template's own Branding tab sets a different font than your brand.

The language comes from the Language field of the action, else from the customer, else it is the main language. If the template does not have the language, the main language is rendered. See Templates in several languages.

The on-screen preview shows the layout, the PDF shows real pages. Page breaks only exist in the PDF. Use Preview PDF to check them, and control them with CSS. See Paper size, margins and file name.

With A specific order selected, the preview searches by order number. Enter the number as shown in your admin, for example #1001. For a product enter its title, for a customer the email or name.

The Template name in the action does not match a template. The name is case sensitive. Compare it with Name on the template's Settings tab. This also happens after a template was renamed or deleted.

Select Template is on on the template's Settings tab.

The template is about one kind of thing, and the workflow does not have it. Use a trigger that provides it, or choose a template that fits the trigger. Renders on the template's Settings tab says what the template needs.

Your allowance is used up. Documents are generated again when the rolling 30-day window frees up, or right away after you change to a larger plan. See Plans and pricing.

The order was deleted, or it is older than 60 days. See the next section.

A temporary problem. The step reports a temporary failure and Flow retries it by itself, you do not need to do anything. If it keeps failing, contact us.