> For the complete documentation index, see [llms.txt](https://docs.cymbal.co/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cymbal.co/help/segmentation/attributes.md).

# Attributes

This page describes how to tag contacts with unique identifiers to use for transactional, promotional, or marketing purposes.

Attributes are a way to assign custom data to a contact that is not included as a default attribute.

For example, Cymbal natively supports attributes such as phone number, email address, tags, and genres. However, if you’d like to store a membership ID or another custom data point for a contact, you can do so by creating a custom attribute.

Once created, custom attributes can be used for audience segmentation, personalization, and targeted marketing or promotional campaigns.

### How to create an Attribute:

1. Select [Audience](https://manager.cymbal.co/audience)
2. Click *Attributes* in the top right corner

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FWftQqpxoxGqUdAEShpRN%2FScreenshot%202026-07-17%20at%2011.57.51%E2%80%AFAM.png?alt=media&amp;token=9cddcc9b-a7cc-4971-b0d5-ebdd69f679f4" alt=""><figcaption></figcaption></figure>

3. You can see past *Attributes* you have created or create a new one

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FdOoYiguAH3j2U9Au6n9Y%2Fimage.png?alt=media&amp;token=fc63296e-705c-4408-8a70-cadd2387ab36" alt=""><figcaption></figcaption></figure>

4. When creating a new *Attribute* you can choose whether it will be a *text* or *number* value

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FvKoF1EOHrTNpIMTIX58y%2FScreenshot%202026-07-17%20at%2011.59.52%E2%80%AFAM.png?alt=media&amp;token=c754e26a-4939-460f-9172-ba426ef1f203" alt=""><figcaption></figcaption></figure>

5. You will see your new *Attribute* appear in the selection modal

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FPoeqhAnd9P6gVGwy4nLv%2FScreenshot%202026-07-17%20at%2012.01.17%E2%80%AFPM.png?alt=media&amp;token=8e477698-057d-4013-8b81-85055c1a7d74" alt=""><figcaption></figcaption></figure>

6. To use this *Attribute*, you’ll need to upload a contact CSV that includes the data you want to assign to each contact

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FA9hz3hBdJzm5ZnAKJokk%2FScreenshot%202026-07-17%20at%2012.06.08%E2%80%AFPM.png?alt=media&amp;token=02fcd545-705b-4d3b-8d8f-9325278b8866" alt=""><figcaption></figcaption></figure>

7. Once the file upload is complete, you can use the *Attribute* to filter contacts, target specific audiences, or dynamically personalize your messages.

<figure><img src="https://3106879467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoQT7U7QQ2l3wKMDKfZ0M%2Fuploads%2FnF3xUG2HmqVXKQrKBe1N%2FScreenshot%202026-07-17%20at%2012.08.56%E2%80%AFPM.png?alt=media&amp;token=e93b50d3-acc9-4fe0-bd7b-61d8073b6d0a" alt=""><figcaption></figcaption></figure>
