> For the complete documentation index, see [llms.txt](https://docs.cw.crisisworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cw.crisisworks.com/security-and-support/technical-reference/merge-template-reference/tips-and-troubleshooting.md). # Tips and Troubleshooting Below are some tips to help when things don't work out right. ## General tips * Start with our included [Additional CSS](/security-and-support/technical-reference/merge-template-reference/css-reference.md) and customise from there * Most HTML tags require a matching opening and closing tag — use indenting to track them — e.g. align `

` and `

` and indent its content * Use an HTML editor to avoid HTML coding mistakes * Develop your layout first, and then insert your tokens * Copy the tokens directly from the Merge Template form to save typos. ## Use CSS classes and semantic tags rather than inline styles The system comes with a default set of CSS classes and semantic tags * Structure your page with CSS classes (e.g. `right-box`, `left-box`) and semantic tags (`, `
`) * Format your text using CSS classes (e.g. `center-text`, `warning-text`, `small-text`) and semantic tags (``, ``) If you need to make changes to how these semantic styles look, these can be controlled in the Advanced CSS field of the merge template. You can also define further classes there. While inline styles are possible (e.g. `
` ), try to avoid them because they lead to inconsistencies and can also be blocked by our security subsystem. ## Using a local HTML editor for faster development While building HTML templates can be difficult, it is possible to get a head start on your fixed layout by using an HTML code editor on your computer. 1. Use a code editor such as Visual Studio Code (free from Microsoft) 2. Create the HTML below to contain the structure of your page 3. Insert the [Base CSS](/security-and-support/technical-reference/merge-template-reference/css-reference.md) and [Additional CSS](/security-and-support/technical-reference/merge-template-reference/css-reference.md) into the document 4. Your template HTML lives within the `` tag. Make all your changes there, and to your Additional CSS style. Do not edit the Base CSS or HTML outside of the body tag. 5. To preview a page, open the page in Google Chrome or Microsoft Edge and print to PDF. 6. Repeat steps 4 and 5 until you're happy with the results. 7. When done, copy all your HTML inside the `` section into the HTML Template field of the merge template, and copy your Additional CSS into the Additional CSS field. While this approach won't allow you to use the full template replacement and conditional logic features, it will allow you to quickly sort out most layout issues. ```html ``` ## Troubles saving a merge template? It might be your HTML. Sometimes you may receive a message "[Your item cannot be saved](/security-and-support/faqs/troubleshooting/system-administration/mail-merge-your-form-could-not-be-saved.md)" when trying to save a custom mail merge template. This can be because our Web Application Firewall (WAF) monitors for "HTML injection" threats, and it has mistakenly detected a threat in your HTML/CSS. If you encounter this issue, here's some things to check: * Avoid inline styles, particularly those that try to insert hidden text or those that re-position text * Keep your HTML template as simple as possible using semantic elements and classes * Avoid defining styles using a `