When the PDF doesn’t look right
Updated November 9, 2026
The PDF ignores my layout
- Is Use a custom layout for this PDF ticked, and did you click Update PDF? Reopen the PDF’s settings to check it saved.
- Is the license active? Without one, PDFs use the template’s normal order. The Custom Field Layout setting says so if the license is the problem.
- Are you opening the right PDF? Each PDF on a form has its own layout.
- Is the template one that prints its own content? See Gravity PDF templates.
- Is Gravity PDF 6.3.0 or later active? See Requirements.
A field is missing
See When a field is left out: it may be hidden by the form, empty, hidden by your rule, or excluded.
Product details or the order total are missing
With a layout, Gravity PDF’s automatic order summary table is turned off. Add your Product and Total fields (and any Option, Quantity or Shipping fields) to the layout where they should print. See Settings KodaLayout changes.
A merge tag prints as typed, or prints nothing
- Printed with its braces: the tag is mistyped or the field ID doesn’t exist. Insert it again with the {..} button.
- Prints nothing: the answer is empty for this entry, or it’s a field with parts and you need a part’s ID, such as
{Name (First):1.3}.
A hide rule doesn’t work
- Matching is exact and case-sensitive. Check spaces and capitals.
- For choices, use the choice’s value, not its label, if they differ.
- For Name, Address, Checkboxes and Consent, pick the right part in the When list.
- is greater than / is less than only work with plain numbers: 1000, not $1,000.
More detail: Hiding items with rules.
An image in an HTML block is missing
- Use the full address, starting with
https://. - Open the address in a private browser window. If it doesn’t load there, the PDF can’t load it either.
- Very large images can slow down or break PDF creation. Resize them first.
Columns or spacing look wrong
- A row holds at most four items; extra items move to the next row.
- Columns share the width equally. Long answers in narrow columns wrap onto several lines.
- Mixed tall and short items? Stack the short ones beside the tall one.
- Check the template: some styles, such as field borders, come from it.
The PDF still shows old content
PDFs with a layout are rebuilt every time, so a stale PDF is usually a browser or download cache. Reload, or open the PDF in a private window. A PDF already attached to a sent email can’t change.
Was this page helpful?
Thanks for letting us know.
