# 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="/files/oXHJf3OIprmrzLnxZUwI" alt=""><figcaption></figcaption></figure>

### Upload the audience file

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

<figure><img src="/files/VkgVsjDkVSxTItYKHoIB" 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="/files/hRkhmY5dFdx9hOOKLd8h" 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> ) }}`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.batch.com/guides-and-best-practices/profiles/how-to-import-an-audience-to-target-specific-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.