Skip to main content

Dynamic Content Tags

Dynamic Content Tags let one email show different content to different recipients. You define the content and the rules once, then place the tag in any email. When each message is sent, Mumara ONE checks the rules against that recipient, the date and the campaign, and inserts the content that matches.

Use them for:

  • Personalized offers, for example one block for VIP customers and another for everyone else
  • Location or language, based on a contact's custom fields
  • Time-sensitive content, such as a weekend promotion or a morning greeting
  • Reusable blocks, such as a standard footer or disclaimer, kept in one place

Quick reference​

TagSyntaxExampleWhat it does
Dynamic content tag[[tag-name]][[vip-offer]]Inserts content chosen by rules you set
Inline condition[if:field]…[endif][if:first_name]Hi %%first_name%%[endif]Shows text only when a condition is true, without creating a tag
Recipient field%%field%%%%first_name%%Inserts the contact's data
Spintax{{tag}}{{greeting}}Picks a value at random. See Spintax.

How a tag works​

A tag holds one or more content units. Each unit has rules and content:

[[greeting-by-region]]
Unit 1 rule: Country is United States --> "Hello from our US team!"
Unit 2 rule: Country is United Kingdom --> "Hello from our UK team!"
Unit 3 no rules (fallback) --> "Hello from all of us!"

When a message is sent, Mumara ONE checks the units from top to bottom. Depending on the tag's setting, it inserts the content of the first unit whose rules all match, or the combined content of every unit that matches.

The Dynamic Content Tags page​

Go to Campaigns → Dynamic Content Tags. Above the table:

  • Add New creates a tag.
  • Templates opens Dynamic Content Tag Templates, ready-made tags you can copy. It appears when templates are available: Clone copies one, Clone All copies them all.
  • Bulk Actions → Delete deletes the tags you've ticked.
ColumnWhat it shows
TagThe tag's name
DescriptionYour note about it
Created OnWhen it was created
ActionsEdit and Delete

Create a tag​

Go to Campaigns → Dynamic Content Tags and click Add New.

  1. Tag. The name you'll use in your emails. Use lowercase letters, numbers and hyphens (-), for example vip-offer or weekend-deal. A tag named vip-offer is used as [[vip-offer]].
  2. Return mode. Choose one:
    • Return the content when the first unit qualifies uses only the first matching unit. This is the default and the usual choice.
    • Return combined content of all qualified units uses every matching unit, one after another.
  3. Content Units. Click [+] Add Content Unit to add a unit. See Content units. Add as many as you need.
  4. Description. Optional notes for yourself.
  5. Click Save.

When ready-made tags are available, Select from the pre-defined templates at the top of the form lists them. Click Use This to fill the form from one, then adjust it.

Content units​

[+] Add Content Unit opens the Dynamic Content Tag Settings window.

Unit Name​

A name to recognize the unit by in the list, for example us-customers or fallback.

Rules​

Each rule is one row: choose a field, then, where needed, which one (for example which custom field), then an operator, then the value. Click + to add another row, and the × at the end of a row to remove it.

All the rules in a unit must match for the unit to qualify: they're joined by and. To match one condition or another, create a unit for each.

A unit with no rules always qualifies. Put one last as a fallback.

Fields you can check​

GroupFieldChecks
Recipient DetailsProfile FieldA field on the contact, such as a custom field
Email AddressThe contact's email address
Is Member ofWhether the contact is on a list
Confirmation StatusWhether the contact has confirmed their subscription
Creation DateWhen the contact was added
List NameThe name of the list the email is sent to
Time and DateTime Right NowThe time of sending
Date TodayThe date of sending
Date Of MonthThe day of the month, 1 to 31
Day Of WeekThe day of the week, such as Monday
This MonthThe month of sending
Broadcast DetailsBroadcast Name, Broadcast Creation Date, Broadcast Group, Broadcast SubjectDetails of the broadcast being sent
AttachmentsWhether the broadcast has attachments
Schedule DetailsSchedule LabelThe name of the scheduled campaign
Campaign TypeRegular, split test or evergreen
Audience TypeWhether the campaign goes to lists or segments

Operators​

The operators offered depend on the field:

  • Text: Is, Isn't, Contains, Doesn't contain, First character is
  • Numbers: Equal to, Not Equal to, Greater than, Lesser than, Greater than or equal to, Lesser than or equal to
  • Dates and times: After, Before, Exactly on, Between, Occurred before, Occurring after, Older than, For the past

If the rule qualifies​

Below the rules, If the rule qualifies holds the content to insert when the unit matches.

  1. Under Select the content type, choose HTML or Text.
  2. Write the content in the HTML Content editor or the Text Content box. The HTML editor has the usual formatting tools, and menus below it insert recipient fields, spintax and other tags.
  3. Click Add Content Unit, or Update Content Unit when you're editing one.

Arrange units​

Units are listed on the tag's page in the order they're checked. Drag a unit by its handle to move it, and use its icons to edit or delete it.

In Return the content when the first unit qualifies mode, order matters: put the most specific units first and the fallback last.

Examples​

VIP offer​

UnitRulesContent
vipProfile Field tier Is VIP, and Confirmation Status Is Confirmed"As a VIP, take 25% off with code VIP25."
everyonenone"Take 10% off with code SPRING10."

Weekend deal​

Weekend content needs two units, because rules in one unit must all match:

UnitRulesContent
saturdayDay Of Week Is SaturdayThe weekend offer
sundayDay Of Week Is SundayThe same weekend offer
weekdaynoneThe weekday content

Morning or afternoon​

UnitRulesContent
morningTime Right Now After 06:00, and Time Right Now Before 12:00"Good morning!"
afternoonTime Right Now After 12:00, and Time Right Now Before 18:00"Good afternoon!"
defaultnone"Hello!"

New subscribers​

UnitRulesContent
newCreation Date For the past 7 daysA welcome block with a getting-started link
defaultnoneNothing, or your usual intro

List members​

UnitRulesContent
newsletterIs Member of your newsletter list"Thanks for reading every week."

RSS feeds in a content unit​

When RSS feeds are available on your account, a content unit also has an Include RSS Feed switch. It fills the unit with the latest items from a blog or news feed, which suits evergreen campaigns that go out on a schedule.

  1. Switch on Include RSS Feed and enter the Feed URL. RSS 2.0, Atom and JSON feeds are supported, for example https://example.com/feed.
  2. Click Fetch Tags. The RSS Tags table lists what the feed contains: each Tag, the Variable to use in your content, Sample Content and a View button.
  3. Use the variables in the unit's content. They have three underscores on each side, such as ___title___ and ___link___.
  4. To show several items, switch on Feed Items Iteration and number the variables: ___title#1___, ___title#2___, and so on.
  5. To keep the content fresh, switch on Update Feed Automatically and choose a Frequency (Yearly, Monthly, Weekly, Daily or Hourly) and a Time of Day.

Variables accept options in curly braces: char limits the length, images=none removes images and style=none removes formatting except lists and line breaks.

<h2><a href="___link#1___">___title#1___</a></h2>
<p>___content:encoded#1{char=300;images=none;}___</p>

The tags available depend on the feed. Fetch Tags shows exactly what yours provides.

Use a tag in your emails​

Insert the tag where the content should appear:

<p>Hi %%first_name%%,</p>
[[vip-offer]]
<p>See you soon,<br>The Example Team</p>
  • Broadcast and drip editors: click Insert Variable, open the Dynamic tab and click the tag.
  • Drag & Drop builder: click Variables, open Dynamic and click the tag to copy it, then paste it into a text block.
  • Or type it, with both pairs of square brackets.

Tags work in broadcasts, drip emails and evergreen campaigns, and in the other emails you write in Mumara ONE, such as trigger notifications and web form emails.

Inline conditions​

For a quick check you don't need a tag at all. Inline conditions go straight into your content and show or hide text depending on the contact's fields.

Show text when a field has a value​

[if:company]You work at %%company%%.[endif]

Add a fallback​

[if:first_name]Hi %%first_name%%![else]Hi there![endif]

Compare values​

[if:country=Canada]Shipping is free across Canada![endif]
[if:plan=enterprise]Contact your account manager.[else]Visit our pricing page.[endif]

Check for an empty field​

[if:phone=]Add your phone number to get SMS updates.[endif]

Several conditions​

[if:membership=gold]Welcome, Gold member![elseif:membership=silver]Welcome, Silver member![else]Join our membership program![endif]

Operators​

OperatorMeaningExample
= or ==Equals[if:status=active]
!=Doesn't equal[if:country!=USA]
>Greater than[if:purchases>10]
<Less than[if:age<18]

List membership​

[ifmemberof:] shows text to contacts on one or more lists, by list name. With several lists, being on any one of them is enough:

[ifmemberof:"Newsletter Subscribers"]Thanks for subscribing![endif]
[ifmemberof:"VIP Customers","Premium Members"]An exclusive offer is inside.[endif]

Tag or inline condition?​

Use an inline condition forUse a dynamic content tag for
A quick check on one fieldSeveral rules together
Fallback text for a missing fieldSeveral different versions of a block
A one-off in a single emailA block you reuse in many emails
List membershipDate, time and campaign rules, and RSS feeds

Manage tags​

  • Edit a tag from its Actions menu. You can change the return mode, the description and the units. The tag's name can't be changed; to rename one, create a new tag and delete the old one.
  • Delete a tag from its Actions menu, or tick several and choose Bulk Actions → Delete.
Tags that are in use can't be deleted

If a broadcast, drip email or web form still uses a tag, Mumara ONE doesn't delete it. Instead, Un-assign Dynamic Content Tags lists where it's used. Remove the tag from those emails, then delete it. When deleting several tags at once, check first that none of them is still in use.

Good practice​

  • Name tags by purpose, such as offer-us, rss-blog or welcome-vip.
  • Always add a fallback unit with no rules, last in the list, so every recipient gets something.
  • Order units from most to least specific in first-unit mode.
  • Test with real contacts. Send test emails with Associate a Contact id set to contacts who should match different units. See Broadcasts.
  • Keep tags focused. A handful of units is easier to follow than dozens.

Troubleshooting​

ProblemWhat to check
Nothing appears where the tag isNo unit matched. Add a fallback unit with no rules, and check the rules against the contact's data.
The wrong content appearsIn first-unit mode, an earlier unit matched first. Move the more specific unit up.
A rule never matchesCheck the value against the contact's field exactly, and that the operator suits the field: text operators for text, number operators for numbers, date operators for dates.
The tag shows as [[tag-name]] in the emailThe name in the email doesn't match the tag exactly. Insert it with Insert Variable instead of typing it.
RSS variables show as textCheck the spelling against the RSS Tags table, with three underscores on each side, and click Fetch Tags again.
RSS content doesn't updateSwitch on Update Feed Automatically, and check the feed still opens in a browser.

Next steps​