Uploading Fans
Last updated
Was this helpful?
Last updated
Was this helpful?
In this guide, we will walk you through how to properly upload fan emails and phone numbers to your ForeverFan account.
Uploading fans to your account allows you to manage your audience directly on our platform. Follow the steps below to prepare and upload your CSV file. Please read all instructions carefully to ensure a smooth process. Note: Fan uploads are not reversible.
Your CSV file should contain at least one contact method for each fan — either an email address or phone number. Any rows missing both will be ignored.
We support the following columns in your upload file:
Column
Description
Required?
Fan’s email address
Required if phone number is missing
number
Fan’s phone number
Required if email address is missing
At least one of email or phone number must be present for each fan.
Column
Description
name
Fan’s full name
city
Fan’s city
region
Fan’s state or province
country
Fan’s country
latitude
Fan’s latitude
longitude
Fan’s longitude
tags
A list of tags, separated by commas (e.g., "VIP,Superfan,Preorder"). Tags should not contain spaces unless they are part of the tag itself.
You can either provide a city and country, or latitude/longitude to result in fan tagged with location.
If you provide latitude and longitude, we will prioritize them and overwrite the city/region/country you enter.
If you provide city and country, you do not need to provide latitude/longitude.
If location data is incomplete or invalid, the fan’s location will not be saved.
We will automatically deduplicate fans based on email address and phone number.
If a fan with the same email or phone number already exists in your account, we will not create a new fan record.
Instead, any new data (such as name, location, tags) will be added to the existing fan record.
Navigate to the Audience section of your dashboard.
Click Upload Fans.
Select your prepared CSV file.
Confirm and upload.
Once uploaded, your data will be processed. Please note:
Uploads cannot be undone. Double-check your file before uploading.
Invalid rows (missing required contact information) will be skipped.
If duplicate emails or phone numbers exist, they will merge into the existing fan record.
All uploaded fan data must comply with our platform’s data and privacy policies.
By uploading, you confirm that you have the necessary consent and legal rights to store and contact these fans.
For your reference, you can download a sample CSV file here. This sample contains 10 example fans and demonstrates the correct formatting and column structure.
If a fan with the same email address or phone number already exists, we will merge any new data into the existing fan record instead of creating a duplicate.
If there is new data that doesn't match (ex. a new location) we will overwrite with the new data.
No. Uploads cannot be reversed. Please double-check your file before uploading.
No. Only email or phone number is required. All other fields are optional but recommended for better audience management.
If you provide only part of a location (for example, just a city and country), we will attempt to fill in the missing data using a geocoding service. Incomplete or invalid locations may be skipped.
Yes, you can. Tags should be provided in the tags
column as a comma-separated list (e.g., VIP,Superfan,Preorder
). Tags will automatically be added to the fan profile.
Without reaching out to our team, you cannot upload more than 500 fans. For increased limits, please contact us at hello@foreverfanmusic.com.
By uploading fans, you certify that you have collected and are handling this data in accordance with all applicable laws and regulations. You are responsible for ensuring that your fan data is compliant.