# Collections

Collections let you upload a reusable list of values (for example cities, SKUs, or emails). You can then reference that list in campaign conditions. This keeps campaigns fast to build and easy to maintain.

***

### 📌 Limits

{% hint style="info" %}
Check these limits before importing:

* **Collection name:** up to **255** characters
* **CSV minimum:** **3** values
* **Collection maximum:** **1,000,000** values
  {% endhint %}

### 📥 Import values from CSV

{% stepper %}
{% step %}

### Create a collection

1. Go to **Collections**.
2. Click **ADD NEW COLLECTION**.
3. Fill in the basic settings.
4. Set the collection to **Active** (if needed).
5. Click **ADD COLLECTION**.

![](/files/BpFTCjx52GrnJgXndTVC)
{% endstep %}

{% step %}

### Upload the CSV

1. Open the collection details (click the collection name).
2. Click **IMPORT VALUES**.
3. Select your CSV file and confirm.

![](/files/qP4XDrT4GYVve9S57Zl6)

![](/files/ibjuehhCH1NZv2da2mgD)
{% endstep %}

{% step %}

### Verify the import

After the upload finishes, the collection list refreshes with new values. You will also see a new import job in **Imports / Exports**.

![](/files/vS6ikw46sVuYblNq9pic)
{% endstep %}
{% endstepper %}

#### Update an existing collection

Use **Update values** to import a new CSV and replace existing values.

![](/files/XpMvTfSVwqxGKQBZAA4i)

### ➕ Add a single value

{% stepper %}
{% step %}

### Open the collection

1. Go to **Collections**.
2. Click the collection name to open its details.
   {% endstep %}

{% step %}

### Add the value

1. Click **Add single item**.
2. Fill in:
   * **Value** (required)
   * **Description** (optional)
3. Click **Save changes**.

![](/files/CDwhVLvkAfrhrGvg9PL0)
{% endstep %}
{% endstepper %}

### ✏️ Edit or delete values

In the collection details:

* Use the **edit** icon next to **Value** or **Description** to change it.
* Use the **⋮** menu on a row to **Delete** it.

***

### 🎯 Use Collections in campaigns

You can select a collection when configuring supported campaign conditions.

![](/files/R94sEUm8UqCdCu2VML8h)

Common places where collections are available:

* **Member fields:** building name, flat/unit name, first name, last name, gender, email, phone number, loyalty card number
* **Address fields:** street, city, postal code, province, country
* **Program fields:** tier, custom attributes, member custom attributes
* **Transaction fields:** channel, delivery city, document number, purchase place
* **Product-related conditions:** transactions with products that have a specific attribute


---

# 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://help.openloyalty.io/main-features/collections.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.