Square data reference

You will learn

Learn what data is synced from Square to Klaviyo, how to view it, and what properties Square events contain.

Before you begin

If you have not already, read our article on getting started with Square for step-by-step instructions on how to integrate your store before continuing with this article.

How to view your data

Make sure your Square integration is enabled. To check on the data sync from Square to Klaviyo:

1. In your Klaviyo account, select Integrations in the left-hand navigation.
2. Select Square from the list.
3. Select the Data tab at the top.

Here, you’ll see recent data synced from Square to Klaviyo, and a progress bar while your historical data sync is in progress.

If you are experiencing issues with your sync, select Restart import in the Historical data section to restart an incomplete historical sync, or Re-import to run it again after it has completed. You need permission to manage integrations to use these controls.

Data synced from Square

Events from Square Online sync to Klaviyo in real time, and events from Square POS sync every 30 minutes.

The data synced from Square to Klaviyo includes:

• Known site visitors tracked as Active on Site events (if you left the onsite JavaScript setting checked)
• Email unsubscribes
• Customer information associated with order events
• Your Square catalog (including POS-only items)
• The following events:
  • Abandoned Checkout
  • Placed Order
  • Ordered Product
  • Refunded Order
  • Cancelled Order
  • Fulfilled Partial Order
  • Fulfilled Order

Square POS order events will sync to Klaviyo (and Klaviyo profiles will be created) if there is an email address and/or phone number associated with the order which the customer directly shared with your company.

Order-level events such as Placed Order and Refunded Order include a Source Name property that identifies the source, such as Square Online or POS, so that you can segment these events in Klaviyo. This property is not included in Ordered Product or Abandoned Checkout events.

Customer information details

Customer profiles sync from Square to Klaviyo if there is an email address and/or phone number associated with the customer which the customer directly shared with your company. Profiles synced from Square to Klaviyo can include the following properties, depending on the data available in Square:

• Email
  Email address of customer
• First name
  First name of customer, if both first and last names are available
• Last name
  Last name of customer, if both first and last names are available
• City
  City of customer
• State/Region
  State of customer
• Zip Code
  Zip Code of customer
• Country
  Country of customer
• Phone number
  Phone number of customer. Klaviyo will only create phone-only profiles if you have set up Klaviyo SMS
• Birthday
  The customer’s birthdate, if provided
• Square Groups
  Square Groups associated with the customer. This does not currently include Square Segments

Email consent

The Square integration syncs email unsubscribe status, but does not sync email opt-in consent. When email_unsubscribed is true in Square, Klaviyo marks the customer as Unsubscribed. When it is false, the sync does not change an existing profile’s email subscription status. New profiles without email consent are marked Never Subscribed.

SMS consent

SMS consent collected in Square Online cannot currently sync to Klaviyo. You can collect SMS consent via a Klaviyo form on your Square site.

Catalog item details

Catalog items sync from Square to Klaviyo with the following properties:

• Item name
• Item ID
• Item description
• Item price
• SKU
• URL
• Image URL
• Inventory Quantity
• Inventory Policy
• Category
• Published
• Variants

Synced events and their properties

Abandoned Checkout

This event is triggered 1 hour after a cart has been abandoned in a Square Online store, and can be used in an abandoned cart flow. Square must provide a customer record with a valid email address or phone number for the event to sync.

In order for this event to sync to Klaviyo, you must first turn off abandoned cart emails in Square. To do this:

1. Log in to Square and navigate to your overview page
2. Select Communications > Abandoned Carts
3. Select Disable

The top-level properties of the event in Klaviyo are:

• $value
  Total amount in the cart
• Items
  Items included in the cart
• Collections
  Collections linked to the items included in the cart

Abandoned Checkout events do not include a top-level Item Count property.

Placed Order

This event is triggered when an order is placed on a Square Online store or POS terminal.

The top-level properties of the event in Klaviyo are:

• $value
  Total amount for the order
• Items
  Items included in the order
• Collections
  Collections linked to the items included in the order
• Item Count
  Total number of items included in the order
• Discount Codes
  Names of discounts applied to the order
• Total Discounts
  Total discount amount
• Source Name
  Source of the order (Square Online, POS)
• Location Name
  Square location name

Ordered Product

This event is triggered when an order is placed on a Square Online store or POS terminal. For catalog products sold in whole units, an Ordered Product event is triggered for each unit purchased, up to 100 events per order line. For products sold by weight or another fractional unit, 1 event represents the full quantity purchased.

The top-level properties of the event in Klaviyo are:

• $value
  Value of the product quantity represented by this event, including modifiers and excluding tax
• Name
  Name of the product ordered
• Variation
  Name of the product variant
• SKU
  Product SKU
• ProductID
  Product identifier
• VariantID
  Variant identifier
• Quantity
  1 for each whole-unit event, or the full purchased quantity for a product sold in fractional units
• Collections
  Collections linked to the product
• Variant Option: [option name]
  Value of the named variant option for the product ordered
• Modifier Options: [modifier list name]
  Selected modifier options from the named modifier list for the product ordered

Refunded Order

This event is triggered when an order is refunded on a Square Online store or POS terminal.

The top-level properties of the event in Klaviyo are:

• $value
  Amount refunded
• Receipt Url
  URL of the order receipt
• Source Name
  Source of the order (Square Online, POS)
• Location Name
  Square location name

Cancelled Order

This event is triggered when a customer creates an order in your store but then cancels the entire order. The event Klaviyo tracks includes all of the product information about the items someone purchased including product names and images. Partial cancellations are not supported.

The top-level properties of the event in Klaviyo are:

• $value
  Total amount for the order
• Items
  Items included in the order
• Collections
  Collections linked to the items included in the order
• Item Count
  Total number of items included in the order
• Discount Codes
  Names of discounts applied to the order
• Total Discounts
  Total discount amount
• Source Name
  Source of the order (Square Online, POS)
• Location Name
  Square location name

Fulfilled Partial Order

A Fulfilled Partial Order event is logged for each completed shipment, delivery, or pickup while other fulfillments remain incomplete. When all fulfillments are complete, the final fulfillment is recorded as Fulfilled Order. If Square does not provide item details for a partial fulfillment, the event contains details for the whole order.

The top-level properties of the event in Klaviyo are:

• $value
  Total amount for the fulfillment
• Items
  Items included in the fulfillment
• Collections
  Collections linked to the items included in the fulfillment
• Item Count
  Total number of items included in the fulfillment
• Discount Codes
  Names of discounts applied to the order
• Total Discounts
  Total discount amount
• Source Name
  Source of the order (Square Online, POS)
• Location Name
  Square location name

Fulfilled Order

This event is triggered when an order is fulfilled on a Square Online store or POS terminal. A Fulfilled Order event will be logged on the last fulfillment, if there are multiple tied to an order.

The top-level properties of the event in Klaviyo are:

• $value
  Total amount for the order
• Items
  Items included in the order
• Collections
  Collections linked to the items included in the order
• Item Count
  Total number of items included in the order
• Discount Codes
  Names of discounts applied to the order
• Total Discounts
  Total discount amount
• Fulfillment Status
  Order status reported by Square
• Source Name
  Source of the order (Square Online, POS)
• Location Name
  Square location name

Additional resources