Using Display Conditions in BEE Pro
Conditional statements, easy and fast
Display conditions is a fantastic new feature that allows for conditional statements in email messages created with BEE Pro, easy and fast, like all things in the BEE editor! Display conditions are available in all BEE Pro plans.
Display conditions allow you the ability 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 who the recipient is.
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. Using display conditions, 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 that your sending platform will have to look up. BEE has no way to know whether it's true or not. In this case, BEE Pro simply allows users of the editor to apply that conditional statement to a row of content so that later - at the time of sending the email - your sending platform can parse the HTML, find the conditional statement, and act on it.
To start using display conditions in your messages, you'll need to enable display conditions in your BEE Pro account. This option is available in Settings > General Settings. You'll need to scroll a bit to find the display conditions option.
Please note that: The "Settings / Brand Settings" section is available (and editable) only for Owners, Admins, and Managers. Editors and Contributors are able to see the display conditions in the editor sidebar, but they can't manage, edit and/or delete them.
When the toggle is green, this means you have display conditions enabled. No color 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 BEE Pro account, you'll notice that the setting is now available in the editor sidebar for Row properties.
If you're looking to apply a display condition to your row, select Add condition. This will open a modal over the editor stage.
The name and description fields allow you to clarify what the display condition is being used for. You'll refer to this information in order 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 editor sidebar will change to reflect the conditions you've inserted.
The delete icon allows you to remove the display condition. The icon below this allows you to expand the display conditions in the sidebar so you can review the actual statements.
You can always Edit condition if you need to change it.
Note that the BEE editor will not save your display conditions, so each time you insert a display condition, you'll need to fill out the necessary form. However, the display conditions will always be saved to that particular message or template, so you can carry the conditions between messages or templates by:
- Copying the message that includes display conditions
- Creating a message from a template that includes display conditions
- Creating a template from a message 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 you can turn off all conditions entirely to see what the message 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?
What syntax/characters can be used in the conditional statements?
BEE is agnostic to the language used in the conditional statements, which is determined by your sending platform. The editor will simply add the syntax that you provide before and after the selected row in the HTML document that it will generate when the message is saved. The editor 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: