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
| Tag | Syntax | Example | What 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.
| Column | What it shows |
|---|---|
| Tag | The tag's name |
| Description | Your note about it |
| Created On | When it was created |
| Actions | Edit and Delete |
Create a tag
Go to Campaigns → Dynamic Content Tags and click Add New.
- Tag. The name you'll use in your emails. Use lowercase letters, numbers and hyphens (
-), for examplevip-offerorweekend-deal. A tag namedvip-offeris used as[[vip-offer]]. - 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.
- Content Units. Click [+] Add Content Unit to add a unit. See Content units. Add as many as you need.
- Description. Optional notes for yourself.
- 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
| Group | Field | Checks |
|---|---|---|
| Recipient Details | Profile Field | A field on the contact, such as a custom field |
| Email Address | The contact's email address | |
| Is Member of | Whether the contact is on a list | |
| Confirmation Status | Whether the contact has confirmed their subscription | |
| Creation Date | When the contact was added | |
| List Name | The name of the list the email is sent to | |
| Time and Date | Time Right Now | The time of sending |
| Date Today | The date of sending | |
| Date Of Month | The day of the month, 1 to 31 | |
| Day Of Week | The day of the week, such as Monday | |
| This Month | The month of sending | |
| Broadcast Details | Broadcast Name, Broadcast Creation Date, Broadcast Group, Broadcast Subject | Details of the broadcast being sent |
| Attachments | Whether the broadcast has attachments | |
| Schedule Details | Schedule Label | The name of the scheduled campaign |
| Campaign Type | Regular, split test or evergreen | |
| Audience Type | Whether 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.
- Under Select the content type, choose HTML or Text.
- 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.
- 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
| Unit | Rules | Content |
|---|---|---|
vip | Profile Field tier Is VIP, and Confirmation Status Is Confirmed | "As a VIP, take 25% off with code VIP25." |
everyone | none | "Take 10% off with code SPRING10." |
Weekend deal
Weekend content needs two units, because rules in one unit must all match:
| Unit | Rules | Content |
|---|---|---|
saturday | Day Of Week Is Saturday | The weekend offer |
sunday | Day Of Week Is Sunday | The same weekend offer |
weekday | none | The weekday content |
Morning or afternoon
| Unit | Rules | Content |
|---|---|---|
morning | Time Right Now After 06:00, and Time Right Now Before 12:00 | "Good morning!" |
afternoon | Time Right Now After 12:00, and Time Right Now Before 18:00 | "Good afternoon!" |
default | none | "Hello!" |
New subscribers
| Unit | Rules | Content |
|---|---|---|
new | Creation Date For the past 7 days | A welcome block with a getting-started link |
default | none | Nothing, or your usual intro |
List members
| Unit | Rules | Content |
|---|---|---|
newsletter | Is 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.
- 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. - 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.
- Use the variables in the unit's content. They have three underscores on each side, such as
___title___and___link___. - To show several items, switch on Feed Items Iteration and number the variables:
___title#1___,___title#2___, and so on. - 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
| Operator | Meaning | Example |
|---|---|---|
= 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 for | Use a dynamic content tag for |
|---|---|
| A quick check on one field | Several rules together |
| Fallback text for a missing field | Several different versions of a block |
| A one-off in a single email | A block you reuse in many emails |
| List membership | Date, 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.
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-blogorwelcome-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
| Problem | What to check |
|---|---|
| Nothing appears where the tag is | No unit matched. Add a fallback unit with no rules, and check the rules against the contact's data. |
| The wrong content appears | In first-unit mode, an earlier unit matched first. Move the more specific unit up. |
| A rule never matches | Check 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 email | The name in the email doesn't match the tag exactly. Insert it with Insert Variable instead of typing it. |
| RSS variables show as text | Check the spelling against the RSS Tags table, with three underscores on each side, and click Fetch Tags again. |
| RSS content doesn't update | Switch on Update Feed Automatically, and check the feed still opens in a browser. |
Next steps
- Spintax: vary wording at random
- Broadcasts: put your tags to work
- Evergreen Campaigns: recurring emails with fresh content