Using Conditional Display - Part 1: Contact Attributes

The conditional display option lets you design email templates and campaigns that display unique content elements to the recipient depending on the conditions you set. 

We have divided the conditional display articles into 3 parts. In this first article, we will explain how to use conditional display in the Drag & Drop Editor (Classic) based on contact attributes.

Before you start

Conditional display conditions

builder.png   animation.gif

Conditional display may be applied to an entire content block in the Drag & Drop Editor (Classic) and can be triggered based on three possible conditions: 

  1. a contact attribute - information you have saved in Sendinblue about your contacts to use in email campaigns, automation emails, or transactional emails. You will learn how to use contact attributes in this article. 
  2. params - the transactional parameter(s) that you pass via an API call to send a campaign or a transactional email. We will explain this in the next part: Using Conditional Display - Part 2: Transactional Parameters.
  3. a dynamic list variable - may be used only when the dynamic list option is also enabled for a specific design block in your campaign or transactional email. We will explain this in the last part: Using Conditional Display - Part 3: Dynamic Lists.

Conditional display based on contact attributes allows you to display a specific design block (image, title, text, etc.) based on what you know about your recipient and have saved in your Sendinblue contact attributes. 

For example, let's say we have an online t-shirt store and want to send a personalized email campaign based on some of our contacts attributes: 

  • Whether they are an existing customer or not (Boolean attribute)
  • Their favorite color (text attribute)
  • Their gender (category attribute)

Let's imagine that we know our customer's favorite color and their gender, but we don't know any details about our contacts who have not purchased yet. Our email will promote a t-shirt sale and we will personalize the content using the data available for each contact.

Personalize an email headline 

In this example, the headline is personalized based on whether or not the contact is an existing customer.

Since we have saved this information as a Boolean attribute (the attribute should state one of two options: Yes or No), we have included two unique blocks and configured them so that one appears when the "CUSTOMER" attribute is Yes and another for when this attribute is No. This ensures all recipients will see a single headline block.


Personalize an email image 

We will personalize the image based on two contact attributes: favorite color and gender. To ensure all recipients see an image, it's important to consider the available possibilities for each of our attributes: 

Favorite color: 

  • Blue
  • Green
  • Yellow
  • Pink


  • Male
  • Female
  • Unknown

We know that blue is the most popular color shirt we sell, so we will focus our personalization efforts on this shirt color in our image block.

We will configure conditional display for these design blocks: 

  • Simple blue shirt: displayed to anyone whose attributes for favorite color is blue and whose gender is unknown
  • Blue shirt worn by a male: displayed to anyone whose attributes for favorite color is blue and whose gender is male
  • Blue shirt worn by a female: displayed to anyone whose attributes for favorite color is blue and whose gender is female
  • Multi-color collection of shirts: displayed to anyone whose attribute for favorite color is not blue


Personalize a call-to-action button 

Finally, we will personalize the call-to-action button based on the recipient's favorite color. 

We will include two buttons: one when the recipient's favorite color is known and another when it is not known. 

To create the first button, click on the button text, click the Personalize dropdown list, and select the attribute for favorite color. Sendinblue will now automatically insert the name of their favorite color in the button text like this: "Shop blue t-shirts", "Shop green" t-shirts", etc.

We will enable conditional display for the second button and configure it so that this button will display only if the contact's favorite color does not equal any of our attribute options.

For example, favorite color does not equal: blue, green, yellow, pink. This block will be displayed when the color does not equal blue AND does not equal green AND does not equal pink, etc.

Now, we have a generic "Shop sale t-shirts" button as a fallback.


💡 Good to know
To test your personalizations, send a test email to a contact for whom you would like to preview the personalized email.

⏩ What's next?

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.