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

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FKcUhHlJ9a2i8VaZfxqso%2Fimage.png?alt=media\&token=33b8347b-eaa6-40d2-878f-858ac97fda05)
{% 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.

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FEOgKHM74IjMf2vgZM5kE%2Fimage.png?alt=media\&token=f9e8cad9-d1fe-4704-a624-c4e440d8560e)

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FAb9OrosXDnK4vhYalSxI%2FImport%20Values.png?alt=media\&token=e74749ee-fd4e-47bd-bed2-c0ad95d935f4)
{% 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**.

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FwwA2A7fuv0BwyVcxeEzq%2Fimage.png?alt=media\&token=8e62381f-26a3-40e1-85fa-b4b7ff8a4a71)
{% endstep %}
{% endstepper %}

#### Update an existing collection

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

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FKy6YBVGW5ehwQJ5TOsS6%2Fimage.png?alt=media\&token=78f55ca7-eebe-45e3-8de0-d0998f0a26a9)

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

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2FjMj7arD1AsggopdfQphY%2FAdding%20Item.png?alt=media\&token=5b4e2942-724d-41cf-ab49-b8ff4a817e0d)
{% 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.

![](https://2658975168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcNVX03KZzmrGwJihLiEx%2Fuploads%2F4RrHO1PPbkpHw4KsXV7d%2Fimage.png?alt=media\&token=4e9e03b2-778e-44ea-abca-7ba019b40243)

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