# How to import an audience to target specific users?

Importing an audience allows you to target specific users to test an orchestration in real conditions, to test your dynamic content, or to simply target static segments exported from your userbase (e.g. top 500 buyers) or created by third-party tools. 

There are two types of audiences: **normal audiences** or **rich audiences**. Let's take a look at both!

## 1. Audiences

An [audience](https://doc.batch.com/getting-started/features/customer-engagement-platform/profiles/audiences) allows you to upload a static list of users, which you can then target in your orchestration. To use an audience, follow the steps below.

### Add a new audience

To create a new audience, go to **Data** > **Audiences** and click on **Add audience:**

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FNnqRZoMA6rQYubRcXjnQ%2FCleanShot%202025-09-05%20at%2016.47.19%402x.png?alt=media&#x26;token=cbcae5c4-d9a7-47fa-87d9-b9978fddc921" alt=""><figcaption></figcaption></figure>

### Upload the audience file

Upload a **.txt**, or **.csv file**, with **one Custom ID per line** only:

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FBoWeEeZau9zJfgy1Dxdm%2FCleanShot%202025-05-27%20at%2012.02.51.png?alt=media&#x26;token=972de4fe-10d7-44c4-9ac4-2f141732f915" alt=""><figcaption></figcaption></figure>

### Use the audience in your orchestration

Once the audience is uploaded, create your orchestration and use the audience in your targeting.

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FywdwvUINBtK2neo2EE0P%2FCleanShot%202025-05-27%20at%2014.04.25.png?alt=media&#x26;token=a41af0eb-8efe-4588-946f-d40cd2c499ef" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
You can also upload your audience to the dashboard through the [Audience API](https://doc.batch.com/developer/api/cep/audiences/create).
{% endhint %}

## 2. Rich audiences

A **rich audience** is a static list of users, which you can associate to one or several attributes. You can then call these attributes in your orchestration for personalization purposes.

### Rich audience file

The rich audience file should only contain the Custom User IDs and the associated attributes, each in one column.

* For rich audiences uploaded manually on the dashboard, up to 10 associated string attributes are allowed in the CSV file.&#x20;
* For rich audiences uploaded through our [Audience API](https://doc.batch.com/developer/api/cep/audiences/create), several attributes with different formats can be included.&#x20;

### Personalization

To [personalize](https://doc.batch.com/getting-started/features/customer-engagement-platform/message/personalization#audience-data) your orchestration with the values in your rich audience, first add the audience to the targeting.

In the title/body of your message, use the following code to call the attributes:

* For rich audiences uploaded manually on the dashboard:

&#x20;      `{{audienceAttribute('audience name', 'att1', 'att2')}}`&#x20;

{% hint style="danger" %}
The **att1/2/3...** value should be added as such in the code and should not be changed.
{% endhint %}

* For rich audiences uploaded through the Audience API:

  &#x20;`{{audienceAttribute(<audience name>, <attribute name> ) }}`