> For the complete documentation index, see [llms.txt](https://docs.santacruzsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.santacruzsoftware.com/printui/guides/troubleshooting.md).

# Troubleshooting

## Preflight fails

Review the specific preflight message first. Common causes include missing fonts, unsupported font formats, Adobe Fonts, network links, unsupported InDesign features, embedded images, facing pages, objects with zero width, or document corruption.

If the error is vague, try restarting InDesign, packaging the document, exporting to IDML and reopening, or copying the pages into a new document.

## Fonts are missing or render incorrectly

Confirm that the font is `.ttf` or `.otf`, licensed for server use, embeddable in PDFs, and not only synced through Adobe Fonts.

Avoid mixing TrueType and OpenType files in the same family. Replace old or converted fonts with a complete clean family when possible.

## Links fail preflight

Move linked assets to a local folder or use InDesign Package to collect the document and links. Links from Creative Cloud Library, OneDrive, and network drives can fail preflight.

## Editor output differs from InDesign

Some difference is expected for unsupported or browser-limited features. Check composer settings, editable gradients, transparency effects, non-rectangular text frames, unsupported text ornamentation, and layer flattening.

Final PDF, JPEG, and PNG output should generally match InDesign more closely than the browser editor, but always test the actual output.

## PDF, JPEG, PNG, or IDML generation times out

Large images, complex vector artwork, unpredictable user uploads, and very complex documents can exceed processing time.

Reduce image size, simplify artwork, convert vectors to raster images, set content type to unpredictable when appropriate, or request complex processing through the output API when needed. See [Job Complexity](/printui/guides/job-complexity.md) for the full workflow.

## Document seems corrupted

Try these in order:

1. Quit and reopen InDesign.
2. Package the document and upload from the package.
3. Export to IDML, reopen, save as INDD, and upload the new file.
4. Copy pages into a new document with the same page size.
5. Divide the document in half repeatedly until the problematic object, page, font, or link is isolated.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.santacruzsoftware.com/printui/guides/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.