One person, one record
Fanfare maintains one record per person across your organization: each email address and each phone number belongs to a single customer. If you add or import a phone number without a country code, Fanfare interprets it using your organization’s country.How customer records are created
A customer record is created whenever:- A shopper signs in — They enter their email or phone number and confirm a one-time code. Because Fanfare creates the record when sign-in starts, your list can include shoppers who requested a code without finishing.
- You add them manually — Under Customers → Add Customer, using an email address (name, phone, Status, and Lifetime points are optional). Setting Lifetime points here sets only their lifetime total; their spendable Loyalty balance starts at
0. - You import a CSV into an audience — Any row that doesn’t match an existing customer creates a new record. See Build audiences for supported columns.
- You add them to a waitlist — Using Add person on a sequence’s waitlist creates a customer if that email isn’t on file yet.
- Your developers create them via API — See API keys and embedding.
How CSV imports update existing customers
When you import a CSV, Fanfare matches rows to existing customers by email or phone and updates matched records with any non-empty values in the file:- Name, phone number, and lifetime points overwrite the customer’s existing values whenever those cells aren’t blank.
- Metadata replaces the customer’s existing metadata as a whole rather than merging keys.
- Phone number changes clear the customer’s marketing SMS consent and remove the phone’s verified status.
- Email address is filled in only if the matched customer didn’t already have one.
Signed-in customers vs. guests
Every shopper entering your experience is either signed in or a guest—there’s no intermediate account tier.
Allow guest access (labeled Anyone, as a guest in the create wizard) is configured per distribution on queues, draws, and timed releases. A sequence displays the guest option only when every open or scheduled distribution in it allows guests and the sequence has no audience attached. Adding an audience to a sequence automatically turns guest entry off. See Sequences and routing, Add and gate sequences, and individual setup guides like Set up a queue.
While a guest participates in a queue, draw, or timed release, Fanfare displays a reminder: “Keep this page open. As a guest you won’t get emails or texts.” See What your customers see for the full sign-in flow.
Verified email and phone
An email address or phone number earns a verified checkmark in Customers once the customer signs in using a one-time code sent to it. Customers added manually via Add Customer or Add person, or created through a CSV import, start unverified.Managing customer records
Open any customer’s profile to view their contact details, spend, engagement metrics, audiences, and drop history—and to adjust loyalty points if your loyalty program is active on Pro or above. See Customer profiles for a full walkthrough. Keep these record rules in mind when managing customers:- Editing details: You can’t edit a customer’s name, email address, or phone number directly in the admin form. To update a customer’s name or phone number, import a CSV that matches their record.
- Archiving: Archive permanently removes a customer from Customers—they can’t be restored, and their email or phone number can’t be re-added. Archiving doesn’t block the person from signing in and entering future drops; it simply hides them from your customer list. See Customer profiles before archiving anyone.
- Status (Active / Inactive): An organizational label you can set when adding a customer manually (all other creation methods default to Active). Status doesn’t block drop entry and can’t be used in audience rules.
Example: a member and a guest at the same drop
Northbound Supply Co.’s “Phantom Stitch Anorak Drop” runs two sequences: Inner Circle Early Access (an audience-gated queue from 10:00 to 11:00) followed by Public Draw (opening at 11:00 with Allow guest access enabled).- Signed-in member: Maya Chen is in Inner Circle. At 10:05, she signs in with her email and one-time code and joins the queue on her phone. When she’s admitted, Fanfare emails her that it’s time to check out, and she completes her purchase on her phone—the same browser she entered from.
- Guest shopper: Another visitor arrives at 10:20. Because only the audience-gated queue is open, they see the sign-in screen with no guest option. They return at 11:15, choose Continue as guest, and enter the Public Draw. If they win, they won’t receive an email or text—they’ll need to revisit the page in the same browser before their payment window closes. They earn no loyalty points and won’t appear under Customers.
On Shopify
Customer profiles and archiving work the same way in the Fanfare app in Shopify. On your Shopify storefront, however, visitors start in a guest session automatically: when Allow guest access is enabled, they enter directly as guests without seeing a sign-in prompt—and won’t receive emails or texts unless they select Sign In before entering.Related
Customer profiles
Explore customer details, metrics, and archiving.
Sequences and routing
How sequence gates and guest access work together.
Build audiences
CSV import steps and supported columns.
Loyalty and Fanfair
How loyalty points and Fanfair prioritization work.
Announcements
Marketing SMS consent and customer messaging.