Report Template Placeholders
Every token and block placeholder a Word (.docx) report template can use.
A template is a Word .docx file that controls the look of a report —
branding, layout, and prose — with placeholders the system fills with data. Open the template in
Word and edit freely: headings, prose, tables, page setup, fonts, colours. The system fills two kinds
of placeholders.
Inline tokens
Use anywhere in a paragraph; replaced with a value. Keep each token within a single run (type it in one go) so Word doesn't split it — the composer also coalesces split tokens as a fallback.
| Token | Value |
|---|---|
{{Title}} | Report title |
{{Author}} | Author |
{{GeneratedDate}} | Generation date |
{{Period}} | Full period, e.g. 01 March 2026 – 30 June 2026 |
{{PeriodShort}} | Short period, e.g. Mar – Jun 2026 or Q2/2026 |
{{PeriodStart}} | Period start date only, e.g. 01 March 2026 |
{{PeriodEnd}} | Period end date only, e.g. 30 June 2026 |
{{BrandName}} | Monitored brand |
{{TotalProducts}} | Products monitored |
{{TotalCounterfeits}} | Counterfeits identified |
{{TakedownSummary}} | One-line takedown-status sentence (blank if none) |
{{PriceSummary}} | One-line price-range sentence (blank if none) |
{{TopMarketplace}} | One-line "most counterfeits appear on…" sentence |
Block placeholders
Put each on its own paragraph. The whole paragraph is replaced with generated content (native Word charts, tables, or repeating sections). A placeholder whose data is empty is removed.
| Placeholder | Expands to |
|---|---|
{{chart:global_situation}} | Counterfeits by region (clustered column) |
{{chart:quarterly_trend}} | Quarterly trend by region (clustered column) |
{{chart:marketplace_trend}} | Counterfeits by marketplace, monthly (line) |
{{chart:top_infringers}} | Top infringers by offer count (horizontal bar) |
{{chart:europe_marketplace_pie}}, {{chart:asia_marketplace_pie}}, {{chart:america_marketplace_pie}} |
That region's counterfeits by marketplace (pie) — only emitted when the region has counterfeits |
{{chart:europe_country_line}}, {{chart:asia_country_line}}, {{chart:america_country_line}} |
That region's monthly trend by country (line) — only emitted when the region has counterfeits |
{{table:monitored_marketplaces}} | Monitored-marketplaces table |
{{table:infringers}} | Top-infringers table |
{{table:brand_summary}} |
Per-brand summary table — only resolves inside {{aggregate:begin}}…{{aggregate:end}} (needs more than one brand selected) |
{{regions}} | One section per region: heading, summary, marketplace pie, country line chart, country table |
{{computations}} | Profile computation sections (only when the report selects computations) |
{{analysis_questions}} | Selected analysis-question answers (only when the report includes any) |
{{chart:<region>_marketplace_pie}} /
{{chart:<region>_country_line}}) follow the report's region names lowercased —
currently europe, asia, america. You normally don't need to place
these individually; {{regions}} already includes them per region automatically. Use the
individual keys only if you want a specific region's chart in a specific spot in the layout (e.g. a
"Europe" chapter that isn't part of the auto-generated {{regions}} loop).
Multi-brand region markers
For templates that report on more than one brand, two special (non-scalar) markers wrap sections of the document — put each on its own paragraph, as a matched pair:
| Marker pair | Behaviour |
|---|---|
{{brand:begin}} … {{brand:end}} |
Everything between them is cloned once per selected brand; tokens and block placeholders inside resolve against that brand's own data. |
{{aggregate:begin}} … {{aggregate:end}} |
Everything between them is emitted once, using data aggregated across all selected brands — but only when more than one brand is selected. With a single brand, this whole section is dropped. |
Templates without these markers (e.g. the seeded standard template, or older custom ones) still work — they're filled once using the aggregate dataset regardless of brand count.
Charts are native and editable
Charts are inserted as native Word charts (not images): titles, axis labels, legends, and theme colours always render, the output is vector-crisp, and each chart carries an embedded worksheet so Edit Data works in Word.
Table of contents
If the template contains a Word Table of Contents field, it refreshes automatically when the generated report is opened. No manual "Update Field" step.