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 → AudienceContacts

  • 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 text field has

  • Can have multiple lines of text

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

Tags

This is used when there could be one or more free form text values for an attribute

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

Last updated

Was this helpful?