Template Refinement
Quick answer: Template refinement is how you improve your document generation outputs over time. Review a generated document, note what's not right, then use Marloo AI's chat to update your template instructions - each iteration gets you closer to perfect.
Before You Start
You've already uploaded a document template (see Introduction to Document Generation)
You've generated at least one document using that template
You have the generated document open (either in-app or exported to Word) for review
Why Templates Matter
95% of inaccuracies in generated documents can be traced back to the template. 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. The more precise your instructions, the better your outputs.
Think of it this way: the template is your "macro" control (how Marloo handles sections across all clients), while the generation prompt is your "micro" control (specific instructions for this particular client).
The Refinement Cycle
Template refinement follows a simple loop:
Generate a document for a test client
Review the output line by line
Note everything that isn't right
Update the template using Marloo AI
Regenerate and check if it improved
Repeat until you're happy
Most users get to a solid template within 2-3 refinement cycles.
Step 1: Review Your Generated Document
Export your generated document to Word and do a thorough line-by-line review. Note everything:
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)
Incorrect calculations or data
Standard wording that was changed when it should have been kept verbatim
Generic text where client-specific detail was expected
Tip: Keep your notes in a Word document or the Notes section of the client's profile. You can upload this feedback document directly to Marloo AI later.
Step 2: Open Your Template Editor
Navigate to Templates > Documents in the left sidebar
Click on the template you want to refine
You'll see your template with:
A left navigation panel listing all sections (Global Instructions, Document Information, etc.)
The main editor where you can directly edit template content
The Marloo AI panel on the right with an "Ask anything" chat
Step 3: Understand Template Components
Global Instructions
This is the most powerful section. Use it to set rules that apply across the entire document.
Mandatory vs. Conditional sections:
Create a table listing which sections must always appear and which are optional:
Add instructions like:
"Omit any section from the final document if there is no relevant content for that section."
Formatting rules:
"Always state percentage and dollar figures to two decimal places."
"State each basis point as a separate paragraph or bullet point."
Section Instructions
Each section in your template contains instructions that tell Marloo what content to generate. These can be:
Prompts - instructions for Marloo to generate content (e.g. "Document the client's reasons for seeking advice, including specific goals and concerns discussed in meetings", Global Instructions, etc) - These will have a blue background (use Instruct Marloo button)
Standard text - text that should appear verbatim in every document. Mark this as "Standard" using the toolbar button so Marloo knows not to modify it
Placeholders - dynamic fields in square brackets like [Client Name], [Adviser Name] that Marloo fills from context
Conditional rules - instructions that apply only in certain situations (e.g. "Only include this section if the client has existing insurance being replaced")
The "Instruct Marloo" Button
At the top of the template editor, the Instruct Marloo button lets you provide high-level instructions for the entire template. Use this for broad behavioural guidance.
Step 4: Use Marloo AI to Refine
The Marloo AI chat panel on the right side of the template editor is your biggest lever for improvement. You can:
Ask Specific Questions
Type precise instructions into the "Ask anything" field:
"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"
Upload Feedback Documents
Click the upload icon in the chat panel to attach a Word document containing all your review notes. Ask Marloo to implement the changes:
"I've uploaded my review notes. Please go through each point and update the template accordingly."
Break Down Complex Changes
For best results, make one specific change at a time rather than asking for multiple changes in a single message. If the AI doesn't cooperate on the first try, clarify your instruction - tell it exactly which section to modify and what the change should look like.
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" instructions for tables that must be reproduced exactly
Add row count verification rules
Specify prohibited actions (e.g. "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."
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
Click the Standard button in the toolbar
This tells Marloo to include this text exactly as written
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."
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]."
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 you make to a shared template affect everyone in your organisation. Test changes 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. Tell it exactly which section to modify and what the result should look like. |
Template changes don't show in next generation | Make sure you're editing the correct template. Check that the changes are saved (look for the save confirmation). |
Standard text is being rewritten | Select the text and click the Standard button to mark it as verbatim content. |
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 is clear about when to include/exclude. Use explicit wording: "Do not include this section if..." |
AI loads the whole template instead of generating | This was a known bug that has been fixed. If you still experience it, reach out to support. |
Related Articles
Introduction to Document Generation - how to set up and generate your first document
Document Styling and Branding
Meeting Templates vs. Document Templates