---
description: A guide for uploading wallet lists to Addressable
---

# Import Wallet List

## Overview

Using **Import Wallet List** users can upload their own wallet lists directly through the interface. Uploaded lists will be immediately available in the **Audience Builder** for targeting.&#x20;



## How to upload a file

1. Navigate to the **Wallet List Upload** section.
2. Click on **Upload File** and select your **CSV, XLS, or XLSX** file.
3. The system will validate the file based on the above requirements.
4. Upon successful upload, the wallet list will be available in **Audience Builder** for targeting.

<figure><img src="https://2800906092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmvdGU0ER07OAwIyiroz%2Fuploads%2F7apfGcZeIt07huHI3VJt%2FScreenshot%202025-02-11%20at%2019.41.13.png?alt=media&#x26;token=557d0587-141d-4d9d-9105-a8a1d3b43bd2" alt=""><figcaption></figcaption></figure>

## **File Requirements**

{% hint style="info" %}
Refer to the **bekow file template** for correct formatting:&#x20;
{% endhint %}

{% code title="sample_wallet_list.csv" lineNumbers="true" %}
```csv
0x000cD27F10dFFAC73201258EAA3925c0452051A0
0x1B3d2f8C345A1A67F8E2d5E4A3E905A2D1C2A71E
0x2E59FF8c41E87B0FcD6A27eF3E1C5A1c3D02E42F
0x3F5CE5FBFe3E9af3971dD833D26BA9b5C936f0bE
0x4A5fF8bBA2f6D4E5C785e6c8D1A5E9A3F52bA0B6
0x5b6E54fF28B5B6a9C8B3d2E6F8C7D4A3B6A1A8C2
0x6C7A3F5bE8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9
0x7D8B3C2F5E6A7D4B6A1F8C7A3F5E8D3C2B6A1F4
0x8E9A3F5B6A7D4B6A1F8C7A3F5E8D3C2B6A1F4E5
0x9F5E8D3C2B6A1F4E5D8B3C2F8A7D4B6A5E9A3F5
```
{% endcode %}

#### **Supported File Formats**

* CSV, XLS, or XLSX
* Max File Size: 50MB
* Max Wallets per File: 500K

#### **Supported Addresses**

* Only EVM-compatible wallet addresses are supported (e.g., `0x000cD27F10dFFAC73201258EAA3925c0452051A0`).
* ENS addresses are not supported.
* Smart contract addresses will be ignored.
* Addresses from unsupported chains will be ignored.

#### **File Structure**

* The file **must not contain headers**.
* **Only the first column** will be searched for wallet addresses.

### **Handling Errors**

* If there are errors in the file, a warning icon (triangle) will appear.
* Hover over the triangle to **download the error log**.
* The error log will specify:
  * Row number where the issue occurred
  * Input received
  * Reason for the error (error message)
* If the file contains **both valid and invalid addresses**, the upload status will be marked as **"Incomplete"**.
* **Download the error log** to review and correct any issues.

***

### **Create Audiences**

To create a new audience out of an existing list, press the "create as audience" button

* When saving an audience, **only wallets from supported chains are stored**.
* This means you may see **fewer addresses** in **Audience Builder** than were originally uploaded.

Wallet lists appear in the on-chain categories section in the Audience Builder:

<figure><img src="https://2800906092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmvdGU0ER07OAwIyiroz%2Fuploads%2FqFeSPS0sTIuIIkkEFFwg%2FScreenshot%202025-02-11%20at%2019.55.18.png?alt=media&#x26;token=7d3533f4-4ddd-4ae2-b3db-37f938271133" alt=""><figcaption></figcaption></figure>
