Merge Tags
Merge tags are placeholders that you put in emails and texts. Solidarity Tech replaces each tag with the person's value when it sends the message. For example, {{ user.first-name }} becomes Joe when sent to a Person named Joe.
You can use merge tags in emails, texts, and the text blocks of page forms. Page builder sections, such as 'Text' and 'Custom HTML', show merge tags as plain text. Merge tags use the Liquid template language.
The dashboard email and text editors have a 'Merge Tags' button. It lists common tags for that context. Some tags work only in certain contexts, and the button does not list every tag.
Common Merge Tags
Person Tags
| Tag | Output |
|---|---|
{{ user.first-name }} | Person's first name |
{{ user.last-name }} | Person's last name |
{{ user.full-name }} | Full name |
{{ user.alternate-name }} | Alternate name |
{{ user.preferred-name }} | Alternate name if set, otherwise first name |
{{ user.email }} | Email address |
{{ user.phone-number }} | Phone number |
{{ user.date-of-birth }} | Date of birth (YYYY-MM-DD) |
{{ user.age }} | Age in whole years |
{{ user.city }} | City |
{{ user.state }} | State |
{{ user.zip-code }} | Zip code |
{{ user.branch }} | Person's branch name (scope-aware) |
{{ user.branches }} | Comma-separated list of the person's branches in the sending chapter or organization |
{{ chapter.name }} | Name of the person's chapter |
Scope-Aware Tags:{{ user.branch }}and{{ user.branches }}show only the person's branches in the chapter or organization that sends the message, and in the chapters under it. Branches need the Professional or Enterprise plan.
To show a date of birth as prose, use the Liquid date filter, for example {{ user.date-of-birth | date: "%B %-d, %Y" }}.
Agent Tags
| Tag | Output |
|---|---|
{{ agent.first-name }} | In email blasts, text blasts, and automations, it shows the first name of the person's 'Assigned Agent'. In textbank scripts and Solidarity app text templates, it shows the first name of the team member who sends. |
Organization Tags
| Tag | Output |
|---|---|
{{ organization.name }} | Your top-level organization's name |
In event emails, event texts, and textbank scripts for an event, {{ organization.name }} shows the event's organization or chapter name. For donation receipts, use {{ donation-charge.recipient }} to show the sub-organization or chapter that received the donation.
Donation Tags
| Tag | Output |
|---|---|
{{ user.total-donated }} | Total lifetime donations |
{{ user.most-recent-donation }} | Most recent donation amount |
Donation Receipt Tags
These tags work in the 'Donation Receipt' and 'Donation Refunded' system emails at Settings > System Emails.
| Tag | Output |
|---|---|
{{ donation-charge.recipient }} | The name of the organization or chapter that received the donation. For pages with multiple Stripe payouts, names are joined with " & ". |
{{ donation-charge.amount }} | The charged amount with currency symbol (e.g. $25.00) |
{{ donation-charge.date }} | The charge date (e.g. May 02, 2026) |
{{ donation-charge.receipt-number }} | The receipt number |
{{ donation-charge.receipt-url }} | A public URL to view the receipt in the browser |
{{ donation-charge.type }} | Either One-Time or Recurring |
{{ donation-charge.card.brand }} | The card brand (e.g. Visa) |
{{ donation-charge.card.last4 }} | The last four digits of the card |
Email Wrapper Tags
These tags are available in email wrappers (Settings → Email Wrappers) and in email content that renders inside a wrapper. Unlike most merge tags, these use underscores rather than hyphens. Social media URLs come from your Social Media settings.
| Tag | Output |
|---|---|
{{ organization.twitter_url }} | X (Twitter) URL from Social Media settings |
{{ organization.facebook_url }} | Facebook URL |
{{ organization.instagram_url }} | Instagram URL |
{{ organization.tiktok_url }} | TikTok URL |
{{ organization.youtube_url }} | YouTube URL |
{{ organization.bluesky_url }} | Bluesky URL |
{{ organization.discord_url }} | Discord URL |
{{ organization.mastodon_url }} | Mastodon URL |
{{ organization.threads_url }} | Threads URL |
{{ organization.upscrolled_url }} | Upscrolled URL |
{{ organization.image_url }} | Organization logo image URL |
{{ organization.mailing_address }} | Organization mailing address |
{{ unsubscribe_url }} | Personalized unsubscribe link for the recipient |
{{ wrapper_header_image_url }} | The wrapper's custom header image URL |
{{ wrapper_footer_image_url }} | The wrapper's custom footer image URL |
For social link icons, {{ social_icons.<network> }} returns a black icon URL and {{ social_icons_white.<network> }} returns a white icon URL. Use the network name from the URL tag, such as instagram. Social media URL and icon tags work only in emails.
Using Default Values
If a Person doesn't have a value for a field, you can provide a fallback using the default filter. For example, Hi {{ user.first-name | default: 'friend' }}, welcome! outputs "Hi friend, welcome!" if no first name is available.
Page Link Merge Tags
Page link merge tags create a personal link for each recipient. Always use page link merge tags when sending links to your Pages via email or text. The page's 'Recognizes User' setting decides if the link recognizes the person. Fields set to 'Visible If Blank' then stay hidden when the person already has a value, and you avoid duplicate records from re-entered phone numbers or emails.
For example, use Sign up here: {{ action-page.join }} instead of Sign up here: https://myorg.solidarity.tech/join.
Context-Specific Tags
Event tags include:
{{ event.title }}- Event name{{ event-session.start-time }}- Session start time{{ event-session.location-address }}- Event location{{ event-session.confirm-rsvp-url }}: Personalized link that confirms an existing RSVP. It works only when RSVP confirmations are on for the event.{{ event-session.cancel-rsvp-url }}- Personalized link to cancel an RSVP{{ event-session.add-to-calendar-url }}- Personalized link to add the event to a calendar app
Event emails, event texts, and textbank scripts for an event can use the title, time, and location tags. The tags render blank in email blasts, text blasts, and automation 'Send a Text' steps.
Custom User Properties you've created are also available as merge tags.
Updated 18 days ago