Square data reference

Estimated 6 minute read

|

Updated Oct 27, 2025, 12:00 AM EST

Table of contents

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.

Square data reference - 图1

Square data reference - 图2

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:

  • EmailEmail 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
  • BirthdayThe customer’s birthdate, if provided
  • Square Groups Square Groups associated with the customer. This does not currently include Square Segments

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 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 NameSource of the order (Square Online, POS)
  • Location NameSquare 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
  • VariantIDVariant 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 UrlURL of the order receipt
  • Source NameSource of the order (Square Online, POS)
  • Location NameSquare 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
  • ItemsItems 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 NameSource of the order (Square Online, POS)
  • Location NameSquare 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 NameSource of the order (Square Online, POS)
  • Location NameSquare 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 StatusOrder status reported by Square
  • Source NameSource of the order (Square Online, POS)
  • Location NameSquare location name

Additional resources

Learn how to easily integrate Klaviyo with your Square Online site in order to sync customer profile, order, and catalog information to Klaviyo, along with order data from your Square Point of Sale (POS). With this data, you’ll be able to reach customers with targeted messaging through segmentation, automated flows, and campaigns. - Getting started with segments

Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages. - Getting started with flows

Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.

Was this article helpful?

YesNo

Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community

Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.

Visit Community

Partners

Hire a Klaviyo-certified expert to help you with a specific task, or for ongoing marketing management.

Hire a partner

Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance Availability varies by location and plan type

Log in