How to use GoHighLevel merge fields in a Word document
By Jake Marsh · Updated
To use GoHighLevel merge fields in a Word document, type them in double braces in a .docx file, such as {{contact.first_name}} or {{custom_values.license_number}}, and upload it to Foliowell. The Merge fields tab lists every field your sub-account has, including your custom fields by key, and copies one when you click it. When a workflow runs Generate document, each field is replaced with that contact's data and the file is saved as a PDF or Word document.
The fields
| Data | Examples |
|---|---|
| Contact | {{contact.first_name}}, {{contact.full_name}}, {{contact.email}}, {{contact.address1}}, {{contact.city}} |
| Contact custom fields | by their key, such as {{contact.system_size}} |
| Opportunity | {{opportunity.name}}, {{opportunity.monetary_value}}, {{opportunity.stage_name}}, custom fields such as {{opportunity.site_address}} |
| Business | {{business.name}}, {{business.phone}}, {{business.full_address}} |
| Custom values | {{custom_values.license_number}} |
| Assigned user | {{user.name}}, {{user.email}}: the opportunity's assigned user, or else the contact's |
| Document | {{today}}, {{document.number}}, {{document.template}} |
These are Foliowell's names for the data, written with dots. They look like the {{contact.first_name}} fields in HighLevel's email builder, but they're read by Foliowell, so use the list on the Merge fields tab rather than copying from an email template.
Format a value
Add a filter after a bar:
{{opportunity.monetary_value | money}}prints $6,400.00;money:"EUR"for euros.{{today | date:"MMMM D, YYYY"}}prints a date like October 2, 2026.{{contact.last_name | upper}},lowerortitlechange the case.{{contact.system_size | number:1}}rounds to one decimal.{{contact.tags | join:", "}}lists tags.
When a field is empty
{{contact.company_name | default:"-"}}prints a dash instead of nothing.{{contact.nickname | default:contact.first_name}}falls back to another field.{{#if contact.company_name}}...{{/if}}around a paragraph drops the whole paragraph when the field is empty. Put each marker in its own paragraph and no blank line is left behind.
Show text only for some contacts
{{#if}} takes comparisons: {{#if contact.state == "TX"}}, !=, >, >=, <, <=, contains and not contains for tags, combined with and and or. Numbers compare as numbers; text ignores case. {{#unless ...}} is the opposite.
Steps
- Open the Merge fields tab in Foliowell and click a field to copy it.
- Paste it into your Word document where the value goes, and add a filter if it needs formatting.
- Upload the .docx on the Templates tab. Foliowell lists every merge field it found and any your sub-account doesn't have. One shown as unknown is usually a typo such as
contact.frist_name. - Click Try on a contact, pick a real contact and Download a test copy. Nothing is saved.
- Add Generate document to a workflow and pick the template.
What it costs
Foliowell is $29 a month or $290 a year per sub-account, with 1,000 documents a month, after a 14-day trial of up to 50 documents. Test copies don't count. Install it from the Foliowell page.
Foliowell: Word & PDF Documents
Turn your own Word templates into finished PDFs or Word files from any workflow. $29 a month or $290 a year per business account.
Questions
Does Word break my merge fields?
Word sometimes splits text it has spell-checked into pieces inside the file. Foliowell reads the field as you see it on the page, and the template check shows each field it found, so a field that was split shows up there if anything went wrong.
Can I use merge fields in the file name?
Yes. The template's file name pattern takes them, like Quote {{document.number}} {{contact.last_name}}.
Can I use them in Google Docs?
Write the template in Google Docs, then File > Download > Microsoft Word (.docx), and upload that file.
Do merge fields work in headers and footers?
Headers and footers are kept in the PDF, page numbers included, and the fields in them are filled like the rest of the document.
More Foliowell guides
- How to make certificates of completion for many GoHighLevel contacts at once
- How to create a quote PDF from a GoHighLevel estimate in your own layout
More HighLevel guides
- How to embed a business directory on your website with GoHighLevel (Kioskwell)
- How to prove a customer agreed to your refund policy in GoHighLevel (Exhibitwell)
- How to get client approval by email or text in GoHighLevel (Okaygate)
- How to enforce a late cancellation and no-show policy for class credits in GoHighLevel (Punchkeep)