Executive Summary
Refining your template is the single most effective way to improve your generated documents.
Refinement follows a loop: generate, review line by line, update the template, regenerate.
Upload your review notes and work through them one change at a time using the Marloo AI chat panel.
Most users get a great template within 2-3 refinement cycles.
Why Templates Matter
Your template isn't just a structure - it's a set of instructions that tell Marloo how to handle each section, what to include, what to leave out, and how to format everything. Many inaccuracies in generated documents trace back to the template, which means refining your template is the most effective way to improve your outputs.
Think of it this way: - Template = macro control (how sections work across all clients) - Generation prompt = micro control (specific instructions for one client)
The more precise your template instructions, the better every document.
The Refinement Cycle
Generate a document for a test client (pick one with comprehensive context)
Export to Word and review line by line
Note everything that isn't right - keep your review notes in a document
Upload your review notes to the template editor (see below)
Work through each point one at a time using Marloo AI
Regenerate and compare
Repeat until you're happy
Most users get to a great template within 2-3 cycles.
What to Look For
When reviewing your generated document, note:
Sections that are too vague or too detailed
Missing information that should have been pulled from context
Sections that appeared when they shouldn't have (or vice versa)
Formatting issues - bullet points vs. paragraphs, table structure
Standard wording that was changed when it should have been kept verbatim
Generic text where client-specific detail was expected
Incorrect data handling - wrong figures, missing calculations
Keep your review notes in a document - you can upload them directly to the template editor later.
How to Refine
Go to Templates > Documents and click on your template.
You'll see:
A left navigation panel listing all sections
The main editor where you can directly edit content
The Marloo AI panel on the right with an "Ask anything" chat
Upload Your Review Notes First
The most effective refinement workflow starts with your review notes:
Click the upload icon in the chat panel to attach a Word document with your review notes.
Ask: "I've uploaded my review notes. Please go through each point and suggest template edits accordingly."
Apply changes one by one. Rather than asking Marloo to update everything at once, work through each suggestion individually. This gives you more control and makes it easier to catch any changes that don't look right.
Make Targeted Changes
The chat works section by section - always use the exact section name so Marloo knows where to apply your change. One change per message works best.
Examples:
"Make the Reasons for Seeking Advice section far more detailed"
"Add a conditional rule: only include the Consequences of Replacing Products section if the client has existing insurance and we are recommending replacement"
"Ensure the Basis of Advice section always uses bullet points, not paragraphs"
If Marloo Doesn't Get It Right
Break the request into smaller, more specific instructions. Tell it exactly which section to modify and what the result should look like.
If the chat stops responding well: Press the trash icon at the top of the chat panel to clear the conversation and start fresh. Long chat histories can cause context overload - the AI has to process the full conversation each time, and too much back-and-forth can reduce the quality of its responses. Clearing and starting with a single clear instruction often works better than continued troubleshooting.
Common Refinement Patterns
Tables Not Populating Correctly
If financial tables (needs analysis, asset allocation, cash flow) aren't pulling the right data:
Add explicit instructions about where to source each value
Use "Absolute Verbatim Table Copy" for tables that must be reproduced exactly as they appear in context
Add row count verification rules
Specify prohibited actions: "Do not merge cells, do not change column headers"
Example instruction:
For the Needs Analysis table: pull Life Cover Required from the insurance needs analysis in Notes. Pull Other Provisions from the client's non-super investments and property value in Uploads. Always include a separate row for Property if the client owns property.
Sections Appearing When They Shouldn't
Add conditional rules to Global Instructions:
Only include the "Consequences of Replacing Products" section if the client has existing insurance and we are recommending that it be replaced. Otherwise do not include the entire section.
Use explicit wording. "Do not include this section if..." is clearer than "This section is optional."
Generic Text Instead of Client-Specific Detail
Your template instructions need to be more specific.
Instead of:
Document the client's situation.
Try:
Document the client's current financial position including income, expenses, assets, liabilities, and any recent life changes. Reference specific figures from the fact-find in Uploads and discussions from tagged meetings. Each point should be a separate bullet point with a specific dollar amount or detail.
Standard Wording Being Modified
If Marloo is paraphrasing text that should appear word-for-word:
Select the text in the template editor. If it's highlighted in blue (AI-generated), that's why Marloo is rewriting it.
Click the Instruct Marloo button in the toolbar to switch it to white (locked).
White text is locked - Marloo will include it exactly as written, every time.
Referencing Company Context in Your Template
Templates can reference company context files for standard wordings. If you want a specific section to draw from a company context file, add an explicit reference in the template instructions for that section. For example: "Reference the standardised wordings in 'Standard Insurance Advice Wordings.docx' when writing this section."
Without this reference, Marloo won't know to look at that specific file, even if it's selected as context during generation. See Company Context and Global Instructions for setup.
Static Text Being Overwritten
If locked text is being replaced by AI-generated content, check that it's in a white-background (locked) zone, not a blue-background (AI instruction) zone. Select the text and click the Instruct Marloobutton to switch it to white.
Headings Interpreted as Instructions
If your section headings are being treated as generation instructions (e.g., Marloo tries to "write a summary" because the heading says "Summary of Advice"), use the Instruct Marloo button to mark headings as locked text. Headings should not be phrased as directives.
A Colleague's Name Appearing in All Outputs
If a team member's name is appearing across all generated documents, this is usually not a template issue. Check the header and footer settings in Settings > Company Settings, not the template itself.
Inconsistent Formatting
Add formatting instructions to Global Instructions:
"Always state percentage figures to two decimal places (e.g., 7.50%, not 7.5%)."
"Always state dollar amounts with commas (e.g., $150,000, not $150000)."
"Use bullet points for the Basis of Advice section, not paragraphs."
"State each basis point as a separate paragraph or bullet point."
Risk and Disclaimer Sections
Add standard conditional risk wording to your template:
Standard conditional risks (use where relevant): - If the client is taking on additional debt: [your standard debt risk wording] - If recommending the client retains money in an offset account: [your standard offset risk wording] - If moving funds from a government-guaranteed deposit: [your standard guarantee loss wording]
Using Global Instructions Effectively
Global Instructions is the most powerful section in your template. Use it for rules that apply everywhere:
Mandatory vs. conditional sections: Create a table listing which sections must always appear and which are optional based on the client's situation.
Omit empty sections:
Omit any section from the final document if there is no relevant content for that section.
Formatting standards: Set rules for decimal places, dollar formatting, bullet points, and any stylistic preferences that should be consistent throughout.
Tips
Start with one test client. Use a client with comprehensive context for your first few refinement cycles. This gives Marloo the best chance of producing good output.
Keep a refinement log. Note what you changed and why. This helps if you need to roll back or explain your template to colleagues.
Use the right level of control. Template instructions for repeatable rules, generation prompts for one-off client specifics. Don't try to do everything in the template.
Templates are shared. Changes affect everyone in your organisation. Test with a personal copy first if you're unsure.
Schedule a refinement session. If you're struggling to get your template right, reach out to us. We offer dedicated sessions where our team helps you refine your template hands-on.
It gets easier. The first template takes the most effort. Once you've nailed the structure and instructions, subsequent templates follow the same patterns.
Troubleshooting
Problem | Solution |
Marloo AI chat doesn't make the change I asked for | Break the request into smaller, more specific instructions. Use the exact section name and tell it what the result should look like. If the chat has been going back and forth, press the trash icon to clear it and start fresh. |
Template changes don't show in next generation | Make sure you're editing the correct template and that changes are saved (look for the save confirmation). |
Locked text is being rewritten | Select the text and click the Instruct Marloo button to switch it to white (locked). White text appears verbatim and won't be changed. |
Too many TBC tags in output | Add more context to the client's profile (meetings, notes, uploads) so Marloo has the information to fill those sections. |
Conditional sections still appearing | Check that your conditional rule is in Global Instructions and uses explicit wording: "Do not include this section if..." |
Related Articles
Document Generation Quickstart - End-to-end guide to generating your first document
Tips and Tricks - Best practices for document generation



