Rule-Based Images

How to set display conditions for rule-based images

Last updated

Each image in a rule-based image has display conditions that decide when it shows. Click Update Conditions on an image to open Show This Image.

Add conditions

  1. Use the toggle at the top to choose Match all conditions (AND) or Match any condition (OR).
  2. Fill in the first condition row: pick a type and the details. Click + Add condition for more.
  3. Add more conditions if needed, then click Save.
The Show This Image window with the AND and OR choice and two conditions

Condition types

ConditionChecksPlan
Merge Tag: TextA merge-tag value contains, doesn't contain, equals or doesn't equal your text (not case sensitive)All plans
Merge Tag: NumberA merge-tag number is, is less than or is more than your numberPower and above
Merge Tag: DateA merge-tag date is on, before or after your dateStandard and above
DateToday's date is, is before or is after your dateStandard and above
Day Of WeekToday is a certain dayStandard and above
TimeThe time is at, before or after your timeStandard and above
DeviceDesktop, smartphone or tabletPower and above
Email ClientGmail, Yahoo Mail, Outlook or Apple MailAll plans
Operating SystemAndroid, iPhone, Mac, Linux or WindowsAll plans

Merge-tag dates can be written as YYYY-MM-DD, MM/DD/YYYY, an ISO 8601 date or a Unix timestamp. Time conditions with at match that exact minute only, so for a time window use before or after.

Time zones

Date, day and time conditions use the time zone you pick: a fixed Timezone, or a Dynamic Timezone from a merge tag with values like America/New_York. If the merge tag is empty or invalid, UTC is used.

How the image is chosen

  • Images are checked from top to bottom, and the first one whose conditions match is shown. Put your most specific images first.
  • An image with no conditions is skipped.
  • If nothing matches, the Fallback Image shows, or nothing if you haven't added one.

Test with the simulation

Click Preview. Set a simulated date and time, device, email client, operating system and merge-tag values, then click Simulate to see which image would show. Simulations don't count as views.

Merge-tag conditions are the most reliable. Some email apps, like Gmail, load images through their own servers, so device and operating system conditions can't always tell what the subscriber is using.

To learn more about rule-based images, see our Rule-Based Images page.

Related

Was this article helpful?

Click the image to zoom in. Drag or scroll to look around.