Import Wallet List

A guide for uploading wallet lists to Addressable

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.

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.

File Requirements

Refer to the bekow file template for correct formatting:

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:

Last updated

Was this helpful?