Troubleshooting
Find what you see in the left column, then follow the fix. For signing problems, see E-signature troubleshooting.
Building templates
Section titled “Building templates”| What you see | What to do |
|---|---|
| Validation says “All checks passed”, but the proof is missing values | The test record has no data in those fields. Proof again with a record that has data. |
| ”Repeat source … is not a valid child relationship of …” | The related list is wrong, or you cannot see that object. Pick the list again from the source picker. |
The proof shows raw {{Account.Field}} text | The field was deleted, or you no longer have access to it. Proof the template again to see which. |
| Create draft is missing from the editor | The template has not been published yet. Create draft only appears once a designed template has a published version. A Word-file template has no Create draft: use Upload a new version or Re-publish instead. |
| ”Output formats are now set on each version.” | Allow PDF output, Allow Word output and Lock output format cannot be changed. Pick the formats on a draft’s Formats this version makes card, then publish. See Word output. |
| ”Save the document from Word again to include its pictures.” | The Word draft doesn’t have its pictures stored. Save it once from the Word add-in, then proof again. |
| ”Change the condition: … is on the related list …” | A Show if condition looks at a related list from outside a repeat over that list. Move the block inside a repeat over the list, or check the list with COUNT:. See Repeats and conditional content. |
| ”Change the filter for …: … can’t be read there.” | The repeat’s filter uses a field it cannot reach from where it sits. Use a field on the row, a record the row links to, the repeat around it, or the main record. |
| ”Fix the header of this template.” or “Fix the footer of this template.” | A merge field in the header or footer cannot be filled. The rest of the message says what is wrong with it. |
| ”Pick another related list. Activity History and Open Activities can’t be listed in a document.” | Salesforce only lets admins read these lists, so the document would fail for everyone else. Pick another related list. A template already live with one still works for admins only: create a new draft, change the list and publish. |
| A font prints as Arial or another standard font instead of the one you chose | Your org does not have that font, or it changed and nobody clicked Re-check. Add the font, or click Re-check on the Fonts card in Settings. See Fonts. |
| A font you added named Arial, Helvetica, Times New Roman or Courier New is not used | Expected. Those names always print the PDF engine’s own font. Give your font another name. |
| A font is listed under Used in your templates, not added | A published template names a font Salesforce does not have, so it is replaced with a standard font. Add the font, or change the template’s font. |
| A few characters print in a different font from the rest | The font does not have those characters, so they print from a fallback font that does. |
| A symbol or emoji is missing from the PDF, or the editor warns about a character | The PDF cannot print that character. Use a symbol that prints, for example ✔ instead of ✅. Emoji print only with premium rendering. See Symbols in a PDF. |
| A sorted or limited list prints different rows than expected | Rows are filtered first, then sorted, then cut to Show at most. Check all three on the repeat. Picklists sort in their defined order, not A to Z. |
| A repeat block shows nothing in the proof | The test record has no rows in that related list. Proof with a record that has some, or leave it if an empty list is expected. |
| An error message keeps appearing | Read the message: it says what to fix. If it does not make sense, contact support. |
| The document generated, but something in it is not what you expected | Open the generation’s row in the history. If something had to be left out, it says so there, for example a barcode that did not fit its space, or an image from your connected storage replaced by a note. |
Batches and Flows
Section titled “Batches and Flows”| What you see | What to do |
|---|---|
| A batch shows Running for hours with no progress | Open the batch to refresh its status. If it is still stuck, cancel it and submit it again. |
| There is no combined PDF on the batch row | If the status is Merging, it is still being put together, so wait. If the batch has finished and there is still no file, check the batch’s error summary. |
| Download all as ZIP does not appear | The batch is Combined-only, so there are no separate files, or no records succeeded. |
| A combined batch ends with “The combined PDF wasn’t made:”, or a Flow bundle stops with a Salesforce error | The combined file was too big for Salesforce. Run the batch with fewer records or in Individual mode, or generate the bundle’s templates separately. |
| A Flow stops with a Salesforce error about processing time or memory, and the record it ran on is not saved | Generate Sliick Doc and Generate Sliick Bundle make the document while the Flow waits. A very long document, or more documents in one run than one transaction allows can take more than Salesforce allows, which stops the whole Flow. Use Generate Sliick Docs (Bulk) for long documents or volume. See Flow actions. |
| The Flow creates one batch for every record | The Flow calls the action once per record inside a Loop. Remove the Loop and call the action once, passing all the records together. |
| A record-triggered Flow finishes but no document was made | The action reports a failure rather than stopping the Flow. Add a Decision on the action’s success output, and read errorMessage on the failure path. A Flow that asks for more than one transaction allows (too many documents, or one very long one) is different: it stops with Salesforce’s own error and the record save is rolled back. Use Generate Sliick Docs (Bulk) for volume. |
Importing templates
Section titled “Importing templates”| What you see | What to do |
|---|---|
| ”Unsupported export format (schema v…). Upgrade the Sliick Docs package and try again.” | The file came from a newer version of Sliick Docs. Upgrade Sliick Docs in this org, then import again. |
| ”Unsupported export format (schema v…). Re-export from a current org running Sliick Docs.” | The file is from a very old version. Export it again from an org running a current version. |
| ”Base object “X” does not exist or is not accessible in this org. Skipped.” | The object is missing in this org, or you cannot access it. Fix that, then import again. |
| Warnings that merge fields could not be filled | A field the template uses does not exist in this org. Add the field or change the template, then validate again. You do not need to import again. |
| The imported template is called “X (Imported 1)“ | A template with that name already exists, so the new one was renamed. Rename it from the Library or the editor. |
| The Import Template button (upload icon) is missing from the Library | The user needs the Sliick Docs Admin permission set. |
Everyday generation
Section titled “Everyday generation”| What you see | What to do |
|---|---|
| No templates appear in the Sliick Docs Generator card | No template for this object has been published yet. Ask your admin. |
| Generation fails with a permission error | The template uses a field you do not have access to. Ask your admin to give you access or change the template. |
| The generated file is missing some data | Open the generation’s row. A field that was renamed or deleted, or that you cannot see, is named in the warnings. A field that is simply empty on the record is not listed. Ask your admin to proof and publish the template again. |
| The generated file’s layout looks wrong | Ask your admin to compare it with a fresh proof in the editor. If the two differ, contact support. |
| Only Generate PDF or only Generate Word appears, but you expected both | The template’s live version makes only one format. Ask your admin to publish a new version with both formats ticked. |
| ”Ask for Word instead.” or “Ask for PDF instead.” | The template only makes the other format. Generate that format instead, or ask your admin to publish a version that makes both. |
| ”Ask your admin to publish a version of … that makes PDFs.” | The template’s live version makes Word files only. Your admin can publish a new version with PDF ticked. |
| ”Open this template in Word and save it again with the Sliick add-in, or upload the .docx again, then publish.” | The Word-file template was saved before 3.5, so it makes no Word files until it is saved again. Ask your admin to save it again from the Word add-in, or upload it again, and publish. PDFs from it still work. See Pictures. |
| A large document fails to generate, and the message ends “If this is a large document, tick Generate in background and try again.” | The document took more processing time or memory than Salesforce allows while you wait. Tick Generate in background on the record page and generate again. The file is saved on the record and you are notified when it is ready. See Generate in background. |
| A large Word file fails with Salesforce’s own memory error | Tick Generate in background and generate again, or choose PDF. If it still fails, ask your admin to compress the pictures in Word and save the template again. |
| You get a Document not generated notification | A document you asked to generate in the background failed. The notification gives the reason. Try again, or ask your admin if it keeps failing. |
| A PDF with many large pictures fails to generate | A PDF made inside Salesforce can hold at most 30 MB of pictures. A picture used more than once counts once. Ask your admin to compress the pictures, split the document, or use premium rendering, which has no such limit. |
| You cannot change a Salesforce value in a generated Word file | Expected: values from Salesforce are locked in Word. Edit the wording around them, or ask your admin to set the template’s Salesforce values in Word to Editable. See Word output. |
| Downloads do nothing on Winter ‘27 | Please upgrade to Sliick Docs 3.0 or later. |
| A bundle generated from a record page shows as Failed hours later | The page was closed before the bundle finished. Generate it again and keep the page open until it is done. |
| Word says it “can’t open this file” | Try opening the .docx in Google Docs. If it opens there, the file is fine and your Word install needs repairing. If it does not, ask your admin to publish the template again. |
| A file has disappeared from the record’s Files | The template’s retention period has passed, so the file was removed. Its row stays in the history. To keep files, ask your admin to tick Hold from Deletion on future generations. |
| Two documents on the same record overwrote each other | The template’s file name pattern has no timestamp in it. See File names. |
| Everyone signed, but nobody received the final PDF | See E-signature troubleshooting. The sender can finish it from the record, and there is an automatic fallback. |
What Sliick Docs does not do
Section titled “What Sliick Docs does not do”- Some kinds of font file: you can add your own fonts as
.ttffiles, but not variable fonts,.wofffiles, font collections, fonts with PostScript (CFF) outlines, or fonts that do not allow embedding. A font a template names that your org has not added prints in a standard font until you add it. Chinese, Japanese and Korean text prints correctly without you choosing a font for it. - Emoji in a standard PDF: they print only with premium rendering.
- More than 30 MB of pictures in a standard PDF: a PDF made inside Salesforce can hold at most 30 MB of pictures. Premium rendering has no such limit.
- Merging table cells vertically: you can merge cells across a row, but not down a column.
- Rounded corners on blocks: not supported in PDFs.
- Word output in Combined or Both batch modes: Word batches need Individual mode.
- Word output from a template with a barcode or QR code: the template cannot be saved with both. Make two templates if you need both formats.
- Text watermarks in Word: Word files leave out a text watermark set in Sliick. Image watermarks appear in both PDF and Word.
- Faded image watermarks: an image watermark prints exactly as uploaded. Upload an image that is already as light as you want it.
Standard PDF and Word generation is native to Salesforce by default. The optional premium high-volume rendering handles large, image-heavy documents. It and saving to your own cloud storage both need Sliick Files, are opt-in, and do not change standard generation.