Use the Content visibility feature to show or hide parts of your email based on each recipient’s data. This allows you to send a single email that dynamically adapts to different contacts, depending on specific conditions.

You can control content visibility based on:

• Recipient's device
  Choose to display content only on certain devices. For example, show a compact layout for mobile users and a more detailed version for desktop.
• Contact attributes
  Show or hide sections of your email depending on values stored in contact attributes. For example, you might show a VIP-only message to contacts with the Status attribute set as "VIP".
• Event data
  Personalize content based on actions your contacts have (or haven’t) taken. For example, you could show a promotional block only to contacts who have never placed an order.
• Data feeds
  Display content dynamically using real-time data from external feeds. For example, you can show personalized product recommendations, live pricing, or localized store information based on external data.

How does content visibility work?

Content visibility lets you define rules to show or hide specific content based on set conditions. In email templates, you can use this feature to dynamically display content depending on each recipient’s data, making your emails more personalized and relevant.

Here are some examples of how you can control content visibility in your emails:

• Personalized greetings
  Display "Hello Mr. X" for men, "Hello Mrs. Y" for women, or simply "Hello" if the name or gender is missing.
• Targeted images or promotions
  Show an image of a model wearing the recipient’s preferred clothing size or feature a product in their favorite color.
• Custom promotional messages
  Include special offers in transactional emails based on past purchases or other contact attributes.

Show or hide content in your emails

By default, all content in your emails is visible to every recipient. If you want to show certain content only to specific recipients, you’ll need to apply display conditions based on their devices, contact attributes, or event data. Recipients who don’t meet the condition or whose data is missing won’t see that content.

To apply content visibility rules in the Drag & Drop editor:

1. Select the content block or section you want to show only to specific recipients.
2. In the side panel, open the Content visibility section.
3. Choose which recipients' devices to display the content on. You can choose between All devices, Only on desktop, or Only on mobile.
4. Click Add condition to set your display rules.
   
5. Choose when the content should be visible:
   • All conditions must be true, or
   • At least one condition must be true.
6. Select the data type your condition will be based on:
   • Contact attributes
   • Transactional params (event data)
   • External feed (data feed)
     
7. Use the following tabs to view instructions for each data type:
   Contact attributesTransactional params (event data)External feed (data feed)

   1. Select the contact attribute you want to use (e.g., CUSTOMER).
   2. Choose the operator (e.g., = equals).
   3. Enter or select the value (e.g., Yes).
      
      
      ❗️ Important

      If the attribute is a text value, make sure it matches exactly the attribute in your Brevo account—for example, write BLUE and not Blue.

   1. In the Key field, enter the parameter name (e.g., RSVP for {{ params.RSVP }}).
      
      💡 Good to know

      To learn how to find your parameter, check our dedicated section in the article [Manual] Personalize your messages with dynamic content (Brevo Template Language).
   2. Select the parameter format: Text, Number, Boolean, Date, or Not needed.
   3. Choose the operator (e.g., = equals).
   4. Enter or select the value that triggers content display (e.g., 0 to target contacts who didn’t purchase tickets).
      

   To check whether Natacha is in the list of instructors in our yogaclasses data feed:

   1. In the Key field, enter your feedname from the Data feeds page and the variable in which you want to search the value that will trigger the content display (e.g., yogaclasses.instructor for {{ feed.yogaclasses.instructor }}) 
   2. Select the parameter format: Text, Number, Boolean, Date, or Not needed.
   3. Choose the operator (e.g., = equals).
   4. Enter or select the value that triggers content display (e.g., Natacha).
      
8. Add one or more conditions if necessary by clicking + Add another condition.
9. Click Add condition when you are done adding all conditions.

🎉 Congratulations! You’ve successfully applied display conditions. Once a condition is set, the content block or section will be outlined in light blue and display a slashed eye icon to indicate that visibility rules are active.

⏭️ What's next?

• [Manual] Show or hide content in your emails using if statements

🤔 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.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.