---
title: "Square data reference"
description: "Learn what data is synced from Square to Klaviyo, how to view it, and what properties Square events contain. Additionally, learn how to view your Square data in Klaviyo."
canonical_url: "https://help.klaviyo.com/hc/en-us/articles/11117271030555"
markdown_url: "https://help.klaviyo.com/hc/en-us/articles/11117271030555.md"
locale: "en-us"
category: "Integrations"
section: "Square"
updated: "2026-10-26"
---

# 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](https://help.klaviyo.com/hc/en-us/articles/11117215837211.md) 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.

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/f92fe79dbcf9c617a46291d8d43bbdbfbbcb88ac-1142x394.png?auto=format)

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](https://help.klaviyo.com/hc/en-us/articles/115005076767.md#who-klaviyo-tracks5) 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](https://help.klaviyo.com/hc/en-us/articles/115005237908.md). 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](https://help.klaviyo.com/hc/en-us/articles/4404274419355.md)

- **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](https://help.klaviyo.com/hc/en-us/articles/360026474752.md) 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](https://help.klaviyo.com/hc/en-us/articles/115002779411.md). 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](https://square.online/)

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

- [Getting started with Square](https://help.klaviyo.com/hc/en-us/articles/11117215837211.md)
  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](https://help.klaviyo.com/hc/en-us/articles/115005237908.md)
  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](https://help.klaviyo.com/hc/en-us/articles/115002774932.md)
  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.
