Contacts
The Contacts tab is your lead database in Fanz. It includes everyone who bought tickets (automatically) plus any contacts you import manually or capture through onsite forms.
Accessing contacts
Go to Marketing → Contacts.
Contact types
| Type | Description |
|---|---|
| Buyer | Someone who bought tickets on your Fanz storefront |
| Contact | A manually imported lead or onsite form subscriber who hasn't bought yet |
Buyers are added automatically when they purchase. Contacts must be imported, added manually, or captured via an onsite form.
The Type column in the table shows a colored chip to distinguish between types:
- Blue — Buyer
- Grey — Contact
Contacts table
The table displays all your contacts with search and filter options.
Search
The search bar filters by:
- Email — Find by email address
- Name — Find by first name
- Last name — Find by surname
- Tag — Type a tag name to show all contacts with that tag
Filter by type
Use the type filter to show:
- All — Both buyers and contacts
- Buyers — Only people who have purchased
- Contacts — Only imported leads who haven't purchased
Filter by onsite form
When you open a specific onsite form's stats panel and navigate to its contacts, the list is automatically filtered to show only contacts captured by that form. In this view, the table switches to a compact layout — the list title, description, and add/upload actions are hidden to reduce clutter and keep the focus on that form's subscribers.
Export
Click Export (button above the table) to download your complete database.
The export includes:
- First and last name
- Phone (if the buyer provided it when purchasing or if you imported it)
- Type (Buyer or Contact)
- Tags
- Creation date
💡 For complete historical lists: If you need a list of all emails and phone numbers from your historical buyers, export from here. This is your master database that includes all buyers from all your events, not just one specific event.
Actions menu
Each row has an actions menu (three dots icon) with options that vary by contact type:
For Contacts:
| Action | Description |
|---|---|
| Edit | Modify the contact's information |
| Delete | Remove the contact from your database |
For Buyers:
| Action | Description |
|---|---|
| Block from emails | Prevent the buyer from receiving marketing emails |
| Unblock from emails | Re-enable marketing emails for a blocked buyer |
Note: Blocking a buyer only affects your marketing emails. They can still receive transactional emails (order confirmations, tickets, etc.).
Adding a single contact
Click Add contact to manually add one person.
| Field | Required | Description |
|---|---|---|
| Yes | Contact's email address | |
| Name | No | First name |
| Last name | No | Last name |
| Phone | No | Phone number |
Click Create to add the contact.
Uploading contacts in bulk
Click Upload contacts to import a database from an external source.
Step 1: Upload file
Supported formats:
- CSV file
- XLS/XLSX file
- Public Google Sheets URL
Required columns:
- Email (mandatory)
Optional columns:
- Name
- Last name
- Phone
Step 2: Map columns
A table shows your file's columns with:
- Column name from your file
- Preview of the first 3 values
- "Map to" dropdown to match Fanz fields
- Status (mapped or not)
Auto-mapping: Columns with standard names (email, name, etc.) map automatically. Adjust manually if needed.
Note: You must map the Email column to proceed.
Click Continue to review when done.
Step 3: Review and upload
| Section | Description |
|---|---|
| Contact count | Number of contacts to be imported |
| Tag | Optional label to identify this batch |
| Preview | First 5 contacts being imported |
Why use tags?
Tags help you distinguish contacts from different sources. For example:
- "Facebook Lead Ads 2024"
- "Trade Show Barcelona"
- "Newsletter Subscribers"
Click Upload contacts to start the import.
Handling errors
If there are issues with your file, you'll see errors:
- Empty emails
- Invalid characters
- Invalid email formats
- Missing required fields
Fix the issues in your file and try again. All errors must be resolved before uploading.
Import progress
After clicking upload:
- A progress indicator appears in the bottom right
- Shows how many contacts have been uploaded
- The import runs in the background — you can continue working
Unsubscribe reason history
When a contact unsubscribes from your emails, the platform records an entry in an append-only history log. This gives you a richer audit trail of opt-out activity across your contact lists.
Each history entry captures:
| Field | Description |
|---|---|
| Reason | The reason the contact selected when unsubscribing |
| Source | Where the unsubscribe action originated (e.g. an email campaign link) |
| Status | The contact's email status at the time of the opt-out (e.g. Unsubscribed) |
Because the log is append-only, entries are never modified or deleted — every opt-out event is preserved in order. This helps you:
- Understand why contacts are opting out over time
- Identify patterns in unsubscribe reasons across campaigns
- Keep a reliable record of opt-out activity for your contact lists
Note: This history is recorded automatically whenever a contact unsubscribes. You do not need to configure anything.
Onsite forms and contacts
Onsite forms (popups and embeds) add contacts to your database when someone subscribes. A few things to keep in mind:
- Tags are not applied by default. Contacts captured through an onsite form only receive tags that you explicitly configure in the form settings. No tag is applied automatically unless you set one up.
- Form text defaults to your language. When you create a new onsite form, the default title and subscribe button text are generated in your account's language — not hardcoded in English. The success message shown to subscribers does not include a "check your inbox" subtitle.
- Linked automation flow status. The onsite forms list shows the status of any automation flow linked to each form (e.g. LIVE, DRAFT). You can immediately see whether a flow is active without navigating to the Flows section.
Duplicates are automatically detected. Existing contacts are updated with new information rather than creating duplicates.
Yes. Select contacts in the table and use the delete action.
Use tags during upload. Each batch can have a unique tag, making it easy to filter and segment later.
No hard limit, but very large files may take longer to process. For files over 100,000 rows, consider splitting into batches.
Yes. Every email includes an unsubscribe link. Unsubscribed contacts won't receive future campaigns.
When a buyer clicks the unsubscribe link in an email, they opt out themselves. When you block a buyer from the contacts table, you're manually preventing them from receiving marketing emails. Both have the same effect — blocked/unsubscribed buyers won't receive campaigns.
Yes. Use the "Unblock from emails" option in the actions menu. However, if the buyer unsubscribed themselves, you cannot override their preference.
The platform records the reason they selected, the source of the unsubscribe action, and their email status at the time. These entries are stored in an append-only log and are never modified.
Tags are only added when you configure them explicitly in the form settings. If you want all subscribers from a specific form to be tagged, open that form's settings and add a tag there.
Related articles
- Segments — Group contacts for targeting
- Email campaigns — Send campaigns to contacts