Using Display Conditions
BEE Pro becomes Beefree
We're still the same design suite you know and love, just with a new name. Our team is working hard to update our documentation, but you might still see some information or screenshots that are out of date.
This article applies to both versions of the builder in the Team and Enterprise plans.
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.
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.
The "Settings / Workspace Settings" section is available (and editable) only for Owners, Admins, and Managers. Editors and Contributors can see the display conditions in the builder sidebar, but they can't manage, edit or delete them.
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?
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:
If you have any questions, feel free to contact us.