creation_source breakdown showing where each customer first entered the Directory: POS terminal vs Square Online vs Invoices.
At a glance
A breakdown of new customer records by where they were first captured, the Customers Directorycreation_sourcefield.TERMINALmeans the customer was first added at a POS register,ONLINE_STOREmeans they checked out on Square Online,INVOICEmeans they were created when an invoice was sent. This is the channel-of-first-touch view: it answers “is my retail counter or my website doing the customer acquisition?” which is the foundation for cross-platform attribution on a Square account.
Calculation
Calculated automatically from your Square Online data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.Worked example
A US lifestyle brand on Square: a flagship retail store, a Square Online storefront, and Square Invoices for wholesale and custom orders. The 30-day window covers 14 Mar 26 to 12 Apr 26. The donut shows where the period’s new customers first entered the Directory.
Three things to notice:
- Retail is the acquisition engine, web is the second channel. 61% of new customers are first captured at the POS terminal. That is typical for a brand with strong foot traffic, but it reframes the website’s job: the web channel is acquiring 31% of new customers, not just converting existing ones. A “the website is just for our regulars” assumption is wrong here.
- First-touch is not where they spend. A customer captured as
TERMINALmay later become a heavy web buyer, and vice versa. This card is channel-of-first-touch only. To see where customers actually transact over time, pair it with Revenue by Channel. A large gap between first-touch share and revenue share is the cross-platform migration story. - POS capture depends on the cashier asking.
TERMINALcustomer creation only happens when a register associate collects an email or phone at checkout. A drop in theTERMINALslice often means staff stopped asking, not that fewer customers walked in. That is an operational coaching signal, not a demand signal. Square’sINSTANT_PROFILEsource (auto-created from a card) can fill some of the gap but yields a thinner record.
Sibling cards merchants should reference together
Reconciling against Square
Where to look in the Square Dashboard: Square Dashboard, Customers, Directory. Square does not expose a single “by creation source” donut in the UI, but you can build the comparison with filters: the Directory supports filtering by Creation source (Point of Sale, Online, Invoices, Imported, and so on) and by Date added. Set the same date range you’ve selected here and read each source count off the filtered totals. Other Square Dashboard views that look like the same number but aren’t:- Customers, Directory, total count: the full Directory, not just new records in the window. Filter by Date added to match this card.
- Customers, Insights: aggregates lifetime behaviour (visit frequency, spend) rather than capture source.
- Reports, Sales by customer: order-level, not customer-creation-level. A customer who bought ten times appears once here, but ten orders there.
Cross-connector reconciliation:
The Square one-Directory advantage: because POS, Square Online, and Invoices all write customer records into a single Customers Directory with a
creation_source tag, Square can tell you channel-of-first-touch natively. On platforms where POS is a separate product, retail and web customer lists live apart and this cross-platform first-touch view has to be stitched together by hand.
Known limitations / merchant FAQs
What exactly does creation_source mean? It is the Square Customers Directory field recording where a customer record was first created.TERMINAL means a POS register, ONLINE_STORE means a Square Online checkout, INVOICE means an invoice was sent. Other values (DIRECTORY for manual adds, IMPORT, LOYALTY, INSTANT_PROFILE, THIRD_PARTY) are grouped as “other”. It is first-touch only and never changes once set.
My POS slice dropped. Did foot traffic fall?
Not necessarily, and this is the most important caveat on the card. TERMINAL records are only created when a register associate captures an email or phone at checkout. If the slice falls while order volume holds, the likeliest cause is that staff stopped asking for contact details, a coaching and process issue, not a demand drop. Check order counts before assuming traffic fell.
Does a customer captured in-store but who later buys online move to the Online slice?
No. This card is channel-of-first-touch. Once a record is created with creation_source = TERMINAL, it stays counted as POS-captured forever, even if that customer becomes a pure web buyer. To see where customers actually spend over time, use Revenue by Channel.
Why is there no alert on this card?
It is an attribution and mix card, not a threshold alarm. There is no universally “bad” split, a 90% POS account and a 90% web account can both be perfectly healthy. The value is in watching the mix shift over time and pairing it with revenue and retention cards. If you want movement alerts on the underlying counts, watch New Customers.
What about customers with no source, or imported lists?
Imported customers carry creation_source = IMPORT and fall in the “other” bucket, they were not captured at a live touchpoint, so counting them as POS or Online would distort the acquisition read. Manually added records (DIRECTORY) are likewise “other”. A large “other” share usually means a recent list import or heavy manual data entry.
Can a single checkout create more than one record?
Square deduplicates against existing records by email and phone, so a returning customer does not generate a new record. Occasionally a typo or a different email creates a duplicate; Square’s merge tool consolidates these, and a merge can change which creation_source survives. This is rare and affects small counts only.