# 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**.

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FJZZZHg21JAXUPVWA0gHi%2FScreenshot%202025-10-15%20at%204.10.33%E2%80%AFPM.png?alt=media&#x26;token=22b250d8-e63b-44e7-9592-f4aa44587918" alt=""><figcaption></figcaption></figure>

* On the Attributes tab, click on **+New Attribute**

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FyEe8Xt2ZmzzTjOp8wdyH%2FScreenshot%202025-10-15%20at%205.39.29%E2%80%AFPM.png?alt=media&#x26;token=5098a069-6b2b-40af-a091-8ca2291131ca" alt=""><figcaption></figcaption></figure>

* Search for existing attributes before you create a new one to avoid duplicates. Bird creates many standard attributes already for you&#x20;
  * 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:&#x20;
    * 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:

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FCZ2cYOmBQOOQWzPijj8b%2Fcreate%20attribute.png?alt=media&#x26;token=971c4213-0821-4efc-a5b4-5beaef0d1582" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2F8LXe6TUUQwkJZEhf7anH%2FScreenshot%202025-10-15%20at%205.44.03%E2%80%AFPM.png?alt=media&#x26;token=71fa49b4-0566-42af-b96d-42ccd8297c02" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FEZQ54G1yXusHxXQycVzX%2FScreenshot%202025-10-15%20at%205.52.41%E2%80%AFPM.png?alt=media&#x26;token=5c1312c6-d4f6-47f5-a1bd-b6e290741263" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FBYTWUB8tsPYf1GhCmEbv%2Fmulti-line%20of%20text%20attribute.png?alt=media&#x26;token=35ae4aa7-f9cf-4d25-8c93-5a4603f72be3" alt=""><figcaption></figcaption></figure>

#### **Select**

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

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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2F9jr1RC7vC1KvCHM8MtLc%2FScreenshot%202025-10-15%20at%205.53.15%E2%80%AFPM.png?alt=media&#x26;token=0d62a42e-84c9-4b28-9ce8-38affec35a89" alt="" width="375"><figcaption></figcaption></figure>

#### **Number**

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

* Has decimal places and how many

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FUPPZOP3iGmqiBOrxi4Ot%2FScreenshot%202025-10-15%20at%205.52.53%E2%80%AFPM.png?alt=media&#x26;token=afd7615e-f309-4244-a906-9143dab0996d" alt="" width="375"><figcaption></figcaption></figure>

#### **Date and Date & Time**

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

<div><figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FPBllthBBuwH9TJI8bx1X%2FScreenshot%202025-10-15%20at%205.53.35%E2%80%AFPM.png?alt=media&#x26;token=d1a782d4-c9d3-4507-a022-bcf2b31be904" alt=""><figcaption></figcaption></figure> <figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FBPmRsd84oUPmoJdloKVy%2FScreenshot%202025-10-15%20at%205.53.49%E2%80%AFPM.png?alt=media&#x26;token=05ec7262-f090-4b79-b5bf-a095561bef4a" alt=""><figcaption></figcaption></figure></div>

#### **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)

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FZBP8OemsG3XC2yp3BeSs%2FScreenshot%202025-10-15%20at%205.53.02%E2%80%AFPM.png?alt=media&#x26;token=ca4c122d-732e-4289-9980-5f543ecf885c" alt="" width="375"><figcaption></figcaption></figure>

#### **URL**

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

* Has multiple values

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FUnoF2im96PTbmWLUwGdE%2FScreenshot%202025-10-15%20at%205.53.57%E2%80%AFPM.png?alt=media&#x26;token=393495b3-f581-4309-870d-ab8593bd7d1d" alt="" width="375"><figcaption></figcaption></figure>

#### **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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FLcf7DoY5x52oCN0R0lBW%2FScreenshot%202025-10-15%20at%205.54.07%E2%80%AFPM.png?alt=media&#x26;token=1882402f-dd09-4b21-9fe2-fbdd0b8f4214" alt="" width="375"><figcaption></figcaption></figure>

#### **Tags**

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

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FP3RBN3raUOMNt0kBx5os%2FScreenshot%202025-10-15%20at%205.54.31%E2%80%AFPM.png?alt=media&#x26;token=20695b2d-f885-40ec-a841-3b2f013c7d74" alt="" width="563"><figcaption></figcaption></figure>

### Importing attributes for bulk creation

You can also create attributes in bulk using Import option.

<figure><img src="https://3861485111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU9kiDiTGVD8kkbnKKyEn%2Fuploads%2FdsaD3oZlHaWSHIthM8ft%2FScreenshot%202025-10-15%20at%206.04.38%E2%80%AFPM.png?alt=media&#x26;token=7242f176-fa4c-489d-a849-ef7dd9f4ee77" alt=""><figcaption></figcaption></figure>

### 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
