Authoring tips and limits
Tips for clean output
Section titled “Tips for clean output”- Use tables, not text boxes, to put things side by side. Text boxes can move when documents are generated, and the PDF leaves out rotated or oddly shaped ones.
- Set images to In Line with Text rather than letting them float.
- Set fixed column widths on tables (Table Layout, then AutoFit, then Fixed Column Width). AutoFit to Contents can make columns jump around.
- Accept or reject all tracked changes before saving. Tracked changes can show up as visible text. The add-in warns you if you save with tracked changes.
- Use PNG, JPEG, GIF or BMP pictures if the template must make a PDF. The PDF leaves EMF pictures out. Word often saves pictures as EMF when you paste from another Office app, and many logos are EMF too. There is no limit on the number of pictures. See Pictures.
- Keep the file under 64 MB, each picture under 32 MB, and the document without its pictures under 10 MB. If it is bigger, compress the pictures (Picture Format, then Compress Pictures). A very large file with big EMF pictures can also fail the PDF check in Salesforce. Compress the pictures, or change large EMF pictures to PNG or JPEG, then save again.
- Keep a PDF’s pictures under 30 MB in total. A PDF made inside Salesforce can hold at most 30 MB of pictures. Premium rendering has no such limit.
- A Word file with many large pictures can be too big to make while you wait. On the record page, tick Generate in background, or choose PDF. See Generate in background.
- Stick to fonts your org has. Calibri, Cambria, Georgia and Segoe UI print in look-alike fonts with the same letter widths. Any other font that is not built in or added by your org is replaced with a standard font in the PDF. See Themes and branding.
- Put conditional text inside a sentence where you can, so the sentence still reads naturally when that text is hidden.
What is supported
Section titled “What is supported”- Single fields, parent fields (up to five levels) and built-ins.
- Automatic formatting for currency, percent, date, date-time, checkboxes and picklist labels.
- Repeating tables over child relationships, including one level of nested lists, with a filter, a sort, a row limit (
LIMIT) and groups with subtotals (GROUP BY). Activity History and Open Activities cannot be listed. - Totals: SUM, COUNT, AVG, MIN and MAX over a related list.
- Conditions (if / else) with =, ≠, ordering, contains and NOT; two clauses joined by AND or OR; “show when blank”; and approval history lists.
- Images from a field that holds a Salesforce File, with an optional size.
- Barcodes and QR codes from a field’s value, Code 128 or QR, with an optional size.
- Checking tags, checking the template when you save, Generate from any record as Word or PDF, and new versions of existing templates.
- Converting a Conga template in the open document, under ⚙ Settings, then Experimental. It tells you what it can and cannot convert before it changes anything.
Not in this version
Section titled “Not in this version”- Excel and PowerPoint. Word only for now.
- More than one level of nesting (a list inside a list inside a list).
- Rotated or oddly shaped text boxes, drawing shapes, charts, SmartArt, equations, footnotes and endnotes in a PDF. The PDF leaves them out and keeps the rest of the page; the Word file keeps them. The save results list each one with about which page it is on.
- PDF for templates with tracked changes or fonts embedded in the file. Fix those in Word first, or publish the template as Word only.
- Suggested corrections for a tag that does not match. The pane tells you a tag is unresolved and where it is, but does not guess what you meant.
The pane only offers what your org’s Sliick Docs version supports, so you are never shown options that will not work.