Create contact attributes

Contact attributes let you store information about individual people in your database — such as their name, email, preferences, or behavioral data.
You can use these attributes to segment contacts, personalize campaigns and trigger automations.

Go to the Contact Attributes Section

From the main navigation, go to Marketing → Audience → Contacts
Under 3 Dots menu, click Contact attributes.

On the Attributes tab, click on +New Attribute

Search for existing attributes before you create a new one to avoid duplicates. Bird creates many standard attributes already for you
- Display Name
- First Name
- Last Name
- Gender
- Language
- Country Code
- Country Name
- City
- Province
- Province Name
- Address 1
- Address 2
- Postal Code
- Birthday
- Subscription Attributes:
  - Email Subscription
  - SMS Subscription
  - WhatsApp Subscription
  - RCS Subscription
  - Push Subscription

Create Attribute

If you want to create your own custom attribute, click on +New Attribute and provide following details:

Display Name: This is the name which is shown in the Bird UI for users. It can be edited later
Description: Add optional description which will show as a help text. It can be edited later
Internal Name: This is a unique internal name for this attribute which will be auto-filled based on display name. It can only have small letters and no spaces. Once created, it cannot be edited.
Type: Select the data type such as Text, Date, Number, Select options etc. Once created, type cannot be edited.
Editable: Select if the attribute values can be edited manually in the UI by the users.

There are following data types available:

Text

In addition to the common fields, you can define if the text field has

Can have multiple lines of text

For multiple lines of text, here is an example of what the input would look like if you used it for address:

Select

In addition to the common fields, you can define if the attribute has

Options: UI Labels and internal names (Value)
Has multiple values

Number

In addition to the common fields, you can define if text field has

Has decimal places and how many

Date and Date & Time

You can select based on whether your attribute will accept only date (day, month, year) or timestamp as well

Toggle

You can select whether your data type is boolean and will accept only True/False values

You can define the default value - empty, true (on), false (off)

URL

This is generally used to capture any web links and you can select if it

Has multiple values

Email Address or Phone Number

This is generally used to capture email address and phone numbers. You can define if this attribute

Has multiple values

Importing attributes for bulk creation

You can also create attributes in bulk using Import option.

Add values to contact attributes

Once the attribute is created, you can add their values using following methods:

Manual update: Edit a contact record directly from the UI.
CSV import: Upload a file with a column that matches the attribute internal name.
API: Include the attribute in the contact create/update API call.
Integrations: Sync data automatically from external sources (e.g., CRM, Ads, forms).
Flows/Journeys: Use rules to auto-set values based on events or other data in a flow or journey

Managing contact attributes

You can edit display name and description anytime. You can edit if it is editable or not.
You can archive unused attributes. You cannot delete an attribute
You cannot edit the internal name
You can add new options to Select type attribute