Using Display Conditions

Overview

The Display conditions feature allows for conditional statements in your designs.

Display conditions allow you to pick a condition (or write one from scratch if you are technically savvy), apply it to a row, and thus show different content based on the recipient.

For example, there could be a row that contains information that will only be shown if the recipient of the email is a current user of a certain product, meaning the display condition is true. You can hide the same content from subscribers who are not already using that product, meaning the display condition is false.

The condition "is this a current user?" is something your sending platform will have to look up. Beefree has no way to know whether it's true or not. In this case, Beefree allows users of the builder to apply that conditional statement to a row of content so that later - at the time of sending the email - your sending platform can process the HTML, find the conditional statement, and act on it.

Getting Started

To start using display conditions in your emails, you'll need to enable display conditions in your Beefree account. This option is available in Settings > General Settings. You'll need to scroll a bit to find the display conditions option.

When the toggle is purple, this means you have display conditions enabled. No colour will be shown on the toggle when they are disabled. You can also keep an eye out for the confirmation message in the lower right-hand corner of the page.

Creating Display Conditions

Now that display conditions are enabled in your Beefree account, you'll notice that the setting is now available in the builder sidebar for Row properties.

If you're looking to add a display condition to your row, select Add condition. This will open a modal over the builder stage.

The name and description fields allow you to clarify what the display condition is used for. You'll refer to this information to preview the results of your display conditions. 

The before and after fields are where you will insert your display conditions syntax. 

Select Confirm to save your new display conditions. Once it's saved, the display conditions section of the builder sidebar will change to reflect the conditions you've inserted.

The delete icon allows you to remove the display condition. The icon below this will enable you to open the popup so you can review the actual statements.

You can always Edit the condition if you need to change it.

Note that the builder will not save your display conditions, so you'll need to fill out the necessary form each time you insert a display condition. However, the display conditions will always be saved to that particular email or template so that you can carry the conditions between emails or templates by:

• Copying the email that includes display conditions
• Creating an email from a template that includes display conditions
• Creating a template from an email that includes display conditions

Previewing Display Conditions

Trying to get an idea of what your email will look like once your sending platform determines whether or not the conditions are true? No problem! Use the Actions dropdown menu and select Preview. You'll find a drop-down menu in the Preview mode navigation bar titled Select row conditions.

The color fill on the toggle button indicates that the conditions are turned on. You can turn off individual conditions or turn off all conditions entirely to see what the design would look like if all conditional statements are false for the recipients.

Frequently asked questions about Display Conditions

Can the image and text displayed in the row be dynamic?

Sure, it's entirely up to you what the content in the row is. So you can certainly use merge tags and dynamic images. What syntax/characters can be used in the conditional statements?

Beefree is agnostic to the language used in the conditional statements, determined by your sending platform. The builder will add the syntax you provide before and after the selected row in the HTML document that it will generate when the email is saved. The builder will not perform any validation on the provided syntax.

Not sure what sort of display conditions are supported by your ESP? Here's some documentation about these conditions in some popular platforms:

• Amazon SES
• Campaign Monitor
• HubSpot
• Klaviyo
• Mailchimp
• SendGrid
• SendinBlue