GoHighLevel glossary

Merge Tag

A merge tag is a placeholder in double curly braces, like {{contact.first_name}}, that GoHighLevel swaps for real data when a message or page is sent.

A merge tag (HighLevel's help docs usually say "merge field") is a placeholder that GoHighLevel replaces with real data at send time. It's written in double curly braces: {{contact.first_name}} becomes the contact's first name, {{custom_values.booking_link}} becomes the sub-account's booking link, and a custom field's tag uses that field's key, such as {{contact.loan_amount}}.

Merge tags work in emails, SMS, workflow actions, funnel and website pages, documents and many other places that accept text. They're case-sensitive, so a tag typed by hand has to match exactly.

In practice

The safe way to insert a merge tag is the picker in the email, SMS or workflow editor, which lists contact, user, appointment, opportunity, custom field and custom value tags. Emails also support a fallback value, so "Hi {{contact.first_name}}" can fall back to something like "there" when the field is empty.

Merge tags break quietly. If a field key is mistyped, or a tag is copied from one sub-account into another where that field doesn't exist, the message goes out with a blank where the data should be. Agencies that reuse templates across clients run into this when the same field has a slightly different key in different sub-accounts.

Where it shows up in RGS Tools

Field Finder's field browser shows the ready-to-paste merge tag on every custom field row, with one-click copy, and sub-account compare flags fields missing from one sub-account before a template breaks there. Every Sub-Account Manager bulk field creator run ends with the new fields' keys and merge tags, ready to copy or download.

Related terms

Custom FieldCustom ValueField KeyWorkflow

Guides that mention Merge Tag

Sub-Account Manager

How to Bulk Create Custom Fields in GoHighLevel

How to bulk create custom fields in GoHighLevel with snapshots or the API, what to plan before you build, and a faster paste-a-list option for agencies.

5 min read
Field Finder

How to Compare Custom Fields Between GoHighLevel Sub-Accounts

Three ways to compare custom fields between sub-accounts in GoHighLevel, what to look for besides missing fields, and how to keep snapshots in sync.

4 min read
Field Finder

How to Find a Custom Field Key in GoHighLevel

Where GoHighLevel shows custom field keys and merge tags, how to copy them without typos, and a faster way for agencies running many sub-accounts.

5 min read
Sub-Account Manager

GoHighLevel Sub-Account Onboarding Checklist for Agencies

A practical GoHighLevel sub-account onboarding checklist for agencies: snapshot, phone and A2P, email domain, fields, users, integrations and backups.

5 min read
Field Finder

GoHighLevel Custom Objects Fields: Setup, Keys and Limits

How GoHighLevel custom objects fields work: creating an object, adding fields, finding their keys, native limits as of October 2026, and merge tag caveats.

4 min read
Field Finder

GoHighLevel Custom Values vs Custom Fields: When to Use Each

The real difference between GoHighLevel custom values and custom fields, how their merge tags look, and how to keep both organized across sub-accounts.

5 min read
All 6 tools, all 34 features: $149/month

Every tool above plus everything we release next. $302/month bought separately. 7 days free, cancel any time.

Start the bundle free