Customising Your CMA DOCX Template
This guide explains how to customise your Comparative Market Analysis (CMA) Word template. You are free to design the document layout however you like, as long as you use supported placeholders so the system can automatically populate property, pricing, and market data.
Overview
-
CMA templates are standard Microsoft Word (.docx) files
-
You control layout, branding, fonts, colours, spacing, and wording
-
Data is inserted automatically using placeholders
-
Placeholders must be typed exactly as shown, including braces
{ }
What You Can Customise
You may customise:
-
Headings and section titles
-
Page layout and margins
-
Fonts, colours, and styles
-
Logos and branding
-
Static explanatory text
-
Order of sections
You must not:
-
Change placeholder names
-
Add extra characters inside placeholders
-
Convert placeholders into Word fields or text boxes (unless advised)
How Placeholders Work
Placeholders are text tokens wrapped in curly braces:
{suburb}
{fullAddress}
{avm}
When a CMA is generated, these placeholders are automatically replaced with real data.
Common Placeholder Examples
Property Details
| Placeholder | Description |
|---|---|
{fullAddress} |
Full property address |
{addressLine1} |
Street address |
{addressLine2} |
City / suburb |
{bedrooms} |
Number of bedrooms |
{bathrooms} |
Number of bathrooms |
{parking} |
Parking spaces |
{landArea} |
Land size |
{floorArea} |
House size |
{propertyType} |
Property type |
{yearBuilt} |
Year built |
Pricing & Valuation
| Placeholder | Description |
|---|---|
{recommendedListPrice} |
Suggested listing price |
{priceRange} |
Listing price range |
{saleMethod} |
Sale method |
{cv} |
Council valuation |
{avm} |
REINZ automated valuation |
{medianComparableSale} |
Median comparable sale |
Dates
| Placeholder | Description |
|---|---|
{currentDate} |
Full generated date |
{currentDay} |
Day |
{currentMonth} |
Month |
{currentYear} |
Year |
Conditional Sections (Show / Hide Content)
Some sections only appear when data exists. These use Mustache-style condition blocks.
Example: Improvements Section
{#hasImprovements}
Total Improvements: {improvementsCount}
{improvementsList}
{/hasImprovements}
-
The entire section is hidden if no improvements exist
-
Do not remove the opening
{#...}or closing{/...}tags -
Content must remain inside the block
Supported Conditional Blocks
Examples include:
-
{#hasImprovements} -
{#hasUniqueAttributes} -
{#hasReinzInsights} -
{#hasSales} -
{#hasListings} -
{#hasImages}
Trend Indicators & Icons
Some sections include dynamic trend indicators (up / down / flat).
Example
{#avmTrendUp}{avmTrend}{/avmTrendUp}
{#avmTrendDown}{avmTrend}{/avmTrendDown}
{#avmTrendFlat}{avmTrend}{/avmTrendFlat}
These control which value is displayed depending on market movement.
Do not merge or rename these tags.
Images in Templates
Images are inserted using image placeholders:
{%image0}
{%image1}
...
{%image14}
Rules:
-
Each image placeholder must be on its own line
-
Do not wrap image placeholders in other text
-
Missing images are automatically skipped
Some sections also support conditional image logic:
{#hasImage}{%imageKey}{/hasImage}
{^hasImage}No image{/hasImage}
Comparable Sales & Listings
Sales and listings use repeatable blocks
{#selectedSales}
{address}
{saleDate}
{salePrice}
{/selectedSales}
-
The system repeats this section for each selected sale or listing
-
All content inside the block is duplicated per record
Formatting Best Practices
✔ Use normal paragraph text, not text boxes
✔ Keep placeholders in plain text
✔ Test after each major change
✘ Do not use Word fields or merge fields
✘ Do not nest conditional blocks unless instructed
Troubleshooting
Placeholders not filling?
-
Check spelling and case
-
Ensure braces
{ }are included -
Confirm placeholders are not split across lines
Section missing?
-
Confirm the
{#condition}block exists -
Ensure the closing
{/condition}tag is present
Images not appearing?
-
Ensure placeholders are on separate lines
-
Check image limits (max 15 images)
Template Validation
If a template contains unsupported placeholders or broken blocks:
-
The CMA may generate with missing sections
-
Support may ask you to revert to a known-working version
Need Help?
If you’re unsure whether a placeholder or section is supported:
-
Refer to this guide
-
Contact support with your template attached for review