Creating a Custom Wallet List for your tokengated Campaigns on Shopify - PERCS App

updated on 29 August 2023

In today’s digital age, staying updated with the latest trends and technologies is crucial for businesses. One emerging trend is tokengated campaigns, which restrict access to content, events, products, or discounts to users holding a specific amount or type of tokens. The PERCS Shopify app empowers businesses to execute tokengated campaigns effortlessly.

Target Audience: This article is intended for current and potential clients who want to add a custom wallet list in CSV format to their tokengated campaigns.

Potential Use Cases:

Action Plan

Creating a custom wallet list for your tokengated campaign involves simple steps, which we will explain in detail in this guide. Ensure you have the necessary CSV files and a clear understanding of the PERCS app before starting.

Useful Links

Step-by-Step Guide

Step 1: Prepare Your CSV File

PERCS requires a CSV file with a unique integer in the first column and the wallet address in the second column, as shown in this example:

Example CSV


You can obtain a snapshot of collection holders from websites like etherscan, polygonscan, and basescan by navigating to the collection and selecting 'holders'. From there, you can download a CSV list of holders.

Using this snapshot of the builders collection, we will format it to match the sample CSV:

Sample CSV (How the snapshot will look like)

  • Delete unnecessary data
  • Move wallet addresses to column 2
  • Enter unique integers in column 1 (drag or use macro)
  • Save

Step 2: Upload to PERCS

  • Add a new campaign on PERCS App
  • Go to Audiences and "Add audience"
  • Drag and drop or upload the file to the audience section in PERCS.
  • The audience is now added. Test the campaign to ensure everything is working correctly.


Following this guide, you can easily create a custom wallet list for your tokengated campaign using the PERCS Shopify app. Restricting access to your content, events, or products has never been simpler. Remember to test your campaign before officially launching it. For further assistance, feel free to reach out to

Download PERCS Shopify App and test it on your store for Free! 

Read more