Skip to content

Troubleshooting

Find what you see in the left column, then follow the fix. For signing problems, see E-signature troubleshooting.

What you seeWhat to do
Validation says “All checks passed”, but the proof is missing valuesThe 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}} textThe field was deleted, or you no longer have access to it. Proof the template again to see which.
Create draft is missing from the editorThe 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 choseYour 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 usedExpected. 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 addedA 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 restThe 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 characterThe 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 expectedRows 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 proofThe 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 appearingRead 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 expectedOpen 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.
What you seeWhat to do
A batch shows Running for hours with no progressOpen 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 rowIf 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 appearThe 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 errorThe 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 savedGenerate 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 recordThe 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 madeThe 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.
What you seeWhat 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 filledA 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 LibraryThe user needs the Sliick Docs Admin permission set.
What you seeWhat to do
No templates appear in the Sliick Docs Generator cardNo template for this object has been published yet. Ask your admin.
Generation fails with a permission errorThe 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 dataOpen 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 wrongAsk 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 bothThe 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 errorTick 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 notificationA 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 generateA 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 fileExpected: 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 ‘27Please upgrade to Sliick Docs 3.0 or later.
A bundle generated from a record page shows as Failed hours laterThe 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 FilesThe 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 otherThe template’s file name pattern has no timestamp in it. See File names.
Everyone signed, but nobody received the final PDFSee E-signature troubleshooting. The sender can finish it from the record, and there is an automatic fallback.
  • Some kinds of font file: you can add your own fonts as .ttf files, but not variable fonts, .woff files, 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.