Skip to main content

Document Generation Template Refinement

Written by Janaya Ravji
Updated over 2 weeks ago

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

  1. Generate a document for a test client (pick one with comprehensive context)

  2. Export to Word and review line by line

  3. Note everything that isn't right - keep your review notes in a document

  4. Upload your review notes to the template editor (see below)

  5. Work through each point one at a time using Marloo AI

  6. Regenerate and compare

  7. 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

  1. Go to Templates > Documents and click on your template.

  2. You'll see:

  3. A left navigation panel listing all sections

  4. The main editor where you can directly edit content

  5. 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:

  1. Click the upload icon in the chat panel to attach a Word document with your review notes.

  2. Ask: "I've uploaded my review notes. Please go through each point and suggest template edits accordingly."

  3. 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:

  1. Select the text in the template editor. If it's highlighted in blue (AI-generated), that's why Marloo is rewriting it.

  2. 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

Did this answer your question?