About contact attributes

In Brevo, you can create and use contact attributes to store information about your contacts and personalize your communications.

What is a contact attribute?

Contact attributes are static values that define a contact. They are the different fields that appear on your Contacts page and on your contacts' details page. Contact attributes are key for storing and identifying pieces of information about the contacts in your Brevo account.

What information can I store about my contacts?

Information about your contacts is stored in default contact attributes, columns on the Contacts page, and custom contact attributes.

Default contact attributes

By default, some contact attributes are automatically created by Brevo and cannot be deleted:

Default contact attribute Description
CONTACT_ID Stores the contact ID of your contacts. Brevo automatically creates it when you import your contacts. It is a fixed number that cannot be edited. This contact attribute can only be retrieved after exporting your existing contacts. 
EMAIL Stores the email address of your contacts.
LASTNAME Stores the last name of your contacts.
FIRSTNAME Stores the first name of your contacts.
SMS Stores the phone number of your contacts used for SMS and phone calls.
WHATSAPP Stores the phone number of your contacts used for WhatsApp and phone calls.
LANDLINE_NUMBER Stores the phone number of your contacts used for phone calls.
OPT_IN

Stores whether a contact has checked the GDRP field in your sign-up form. It is automatically updated by Brevo.

DOUBLE_OPT-IN

Stores whether your contacts have confirmed their subscription through a double opt-in process. It is automatically updated by Brevo.

CONTACT TIMEZONE Stores the timezone of your contacts.
EXT_ID Stores the contact ID of your contacts created outside Brevo.
JOB_TITLE Stores the job title of your contacts.
LINKEDIN Stores the LinkedIn URL of your contacts.

Columns

Some other pieces of information that are not contact attributes appear as columns on your Contacts page. They are also automatically created and updated by Brevo and cannot be deleted:

Columns on the Contacts page Description
CONTACT Displays the following identifying information about your contacts, in order of priority: FIRSTNAME and LASTNAME, EMAIL, SMS.
SUBSCRIBED Displays whether your contacts are subscribed to your email, SMS, and WhatsApp campaigns.
BLOCKLISTED Displays whether your contacts are blocklisted from your email, SMS, and WhatsApp campaigns.
CREATION_DATE Stores the date when your contacts were added to Brevo. It is automatically updated by Brevo.
LAST_CHANGED Stores the date when information about your contacts was last updated. It is automatically updated by Brevo.
💡 Good to know
The name of the default attributes may vary based on the account language you selected when you created your Brevo account.

Custom contact attributes

Chances are, you need to store additional information that doesn't fit into the default contact attributes. You can create custom contact attributes to collect any other information you'd like about your contacts and meet your unique needs:

  • Information about your contacts
    For instance, a real estate agent could gather information such as the potential buyers' budget, the desired number of bedrooms, etc.
  • Contacts' preferences
    For instance, you could gather information on how often they prefer to receive emails or the type of content that interests them.
  • Contacts' responses to a form
    For example, you could gather feedback about an event you organized or a product purchased by a contact.

Seven types of custom contact attributes can be created in Brevo: text, date, number, category, multiple-choice, boolean, and user, which you can customize to fit your needs.

➡️ To learn more, check our dedicated article Create and manage custom contact attributes.

Populate contact attributes

Once you have created your contact attributes, you can populate them with the information of your contacts by importing new contacts or updating existing ones:

  • Through a manual entry in your database.
  • Through a bulk import.
  • By copy-pasting information from a spreadsheet.
  • By using a plugin or integration to connect your website to Brevo.
  • By automatically adding contacts from a landing page or sign-up form.

➡️ To learn more, check our dedicated articles How can I add my contacts to Brevo? and Update the information of your contacts.

Use contact attributes

One way to make your contacts feel cared for and nurture your relationship with them is to create personalized experiences. For example, you could suggest similar products to those already purchased by your contacts. To do this, you need to store their information in contact attributes and then target them based on those values.

Expand the following accordions to discover some examples of how you can use contact attributes to create personalized experiences for your contacts:

🎨 Create personalized message content

You can easily personalize your emails, SMS, and WhatsApp messages with contact attributes by adding placeholders, also known as variables, to your content. During sending, these placeholders will be replaced with information about your contacts, such as their name or email address.

The following table shows what placeholders look like in an email and what a recipient would receive:

Email with placeholders Email received by the recipient
placeholders.png email.jpg

To learn how to create personalized message content using contact attributes, check our dedicated articles:

✂️ Segment your contacts

Using segmentation based on contact attributes, you can divide a larger audience into smaller, more targeted groups based on specific characteristics or behaviors. This allows for more personalized and tailored marketing efforts and a better understanding of each group's needs and preferences.

Here is an example of how a pet shop owner could segment their contacts using contact attributes to target French dog owners:

To learn how to segment your contacts, check our dedicated articles:

🚀 Trigger automations

Contact attributes can be used to trigger automations based on specific criteria. For example, you could set up an automation to automatically send a welcome email containing images of dogs to contacts who subscribed to your newsletter and specified they own a dog when filling in your form (and you could do the same with cats or rabbits!). Using contact attributes to trigger these automations can provide a more personalized experience for your contacts and increase the likelihood of conversion.

You can trigger automations using contact attributes by adding the following entry points:

⏭️ 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.

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

💬 Was this article helpful?

21 out of 69 found this helpful