Shopify data reference

A per-tab list of every column SyncRange can export from Shopify, with a short description of what each one contains. Use this page when picking columns in the export builder, or when you need to know exactly what a value represents in BigQuery or Google Sheets.

Each tab below notes whether it uses the export date range or always exports a full current snapshot (date range does not apply).

For configuration steps, refunds and discount semantics, and reconciliation guidance see Configuring Shopify exports.

Products

One row per product variant. Useful for catalog snapshots, pricing, inventory, and metafield reporting. Full export each run: always current catalog data; the date range does not apply.

ColumnDescription
Product IDShopify's numeric ID for the product (the parent of all variants).
Product TitleDisplay title of the product.
Variant IDNumeric ID of the specific variant for this row.
Variant TitleVariant name (e.g. "Small / Red"). "Default Title" when there is only one variant.
SKUStock Keeping Unit for the variant.
BarcodeBarcode (UPC/EAN/ISBN) for the variant.
Product TypeFree-form product category set in Shopify admin.
VendorBrand or supplier name.
Product TagsComma-separated list of tags applied to the product.
DescriptionProduct description (HTML stripped to plain text).
PriceCurrent selling price for the variant in the store currency.
Compare at PriceOriginal / strike-through price used for showing discounts.
WeightVariant weight in the unit specified by Weight Unit.
Weight UnitUnit for the weight value (e.g. kg, lb).
Inventory QuantityTotal quantity available across all locations for this variant.
Inventory PolicyShopify's setting for whether to allow purchase when out of stock.
Requires ShippingWhether the variant is shipped (vs digital).
TaxableWhether tax is collected on this variant.
StatusProduct status: ACTIVE, ARCHIVED, or DRAFT.
PublishedWhether the product is visible on the storefront.
Published DateTimestamp the product was first published.
Created DateTimestamp the product was created.
Updated DateTimestamp the product was last modified.
HandleURL-safe identifier (the slug used in storefront URLs).
Image URLURL of the variant's primary image (or product image if the variant has none).
CollectionsComma-separated list of collections containing this product.
OptionsVariant option values rolled up as a string (e.g. Color: Red, Size: M).
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

You can also add up to 8 product metafield columns (e.g. custom.brand) — see Product metafield columns.

Orders

One row per order. Date range: filtered by the order's created_at. Total Price, Subtotal and Refunded Amount reflect the order's current state (post-refund). Customer Address columns come from the customer's current default account address; Shipping Address columns are the ship-to snapshot stored on the order at checkout (use these when you need where each order actually shipped).

ColumnDescription
Order IDShopify's numeric order ID.
Order NumberCustomer-facing order number (e.g. 1042; the leading # is stripped).
Order DateDate the order was created (YYYY-MM-DD). New: date-only column.
Order Date TimeFull timestamp the order was created (YYYY-MM-DD HH:MM:SS). Add this if you need time-of-day precision.
Customer IDNumeric Shopify customer ID (blank for guest orders).
Customer NameCustomer first + last name.
Customer EmailCustomer email address.
Customer PhoneCustomer phone number.
Customer Address Line 1Customer's current default account address, line 1 (can change over time and may not match where a past order shipped).
Customer Address Line 2Customer's current default account address, line 2.
Customer CityCustomer's current default account address, city.
Customer Province/StateCustomer's current default account address, province or state.
Customer CountryCustomer's current default account address, country name.
Customer Country CodeISO country code for the customer's current default account address.
Customer Zip/Postal CodeCustomer's current default account address, postal code.
Shipping Address Line 1Ship-to address line 1 as stored on the order at checkout.
Shipping Address Line 2Ship-to address line 2 as stored on the order at checkout.
Shipping CityShip-to city as stored on the order at checkout.
Shipping Province/StateShip-to province or state as stored on the order at checkout.
Shipping CountryShip-to country name as stored on the order at checkout.
Shipping Country CodeISO country code for the ship-to address on the order.
Shipping Zip/Postal CodeShip-to postal code as stored on the order at checkout. Blank for digital orders or orders with no shipping address.
Fulfillment StatusShopify display status (e.g. FULFILLED, UNFULFILLED, PARTIALLY_FULFILLED).
Financial StatusShopify display status (e.g. PAID, REFUNDED, PARTIALLY_REFUNDED).
CurrencyOrder currency code (ISO 4217, e.g. USD).
SubtotalCurrent subtotal (line items only, after refunds; matches Shopify's "Total sales" view, excludes shipping).
ShippingShipping charged to the customer at order time.
TaxesTotal tax charged on the order.
DiscountsTotal discount amount applied to the order.
Total PriceCurrent order total (after refunds; matches Shopify's "Total sales" view).
Refunded AmountCumulative amount refunded against this order.
Quantity SoldTotal units sold across all line items in the order.
Discount Codes AppliedComma-separated list of discount codes/titles applied to the order.
Discount Code IDsComma-separated catalog discount IDs (when resolvable for code-based discounts).
Manual Discount CodesCustomer-typed discount codes plus admin-applied manual discount titles.
Automatic Discount TitlesTitles of automatic discounts applied to the order.
Discount Codes Applied (JSON)JSON array of the same values as Discount Codes Applied (for BigQuery/Apps Script parsing).
Discount Code IDs (JSON)JSON array of the resolvable catalog discount IDs.
Order SourceWhere the order came from (e.g. web, pos, shopify_draft_order).
Order TagsComma-separated list of tags applied to the order.
Product TagsComma-separated unique tags from products on the order (from line items).
Order NoteFree-form note attached to the order.
Order Note AttributesJSON array of additional details (key/value pairs) on the order; preserves duplicate keys.
Fulfillment IDOptional. Comma-separated Shopify fulfilment names for the order (e.g. #1001.1). Only fetched when this column is selected.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Up to 3 order metafield columns are also available — see Order metafield columns.

Line Items

One row per line item, shipping line, or refund line on an order. Date range: products and shipping are filtered by the order's created_at; refund rows are filtered by the refund's processed date so refunds on older orders are still picked up. See Reconciling Orders and Line Items for the full filter behaviour.

ColumnDescription
Line Item IDShopify's ID for the line item. For refunds this is {refund_id}_{refund_line_item_id} so it's unique per row.
Order IDNumeric ID of the parent order. Use this to join back to the Orders tab.
Order NumberCustomer-facing order number from the parent order.
Order DateDate the parent order was created (YYYY-MM-DD). Same value across all line items of the same order.
Order Date TimeFull timestamp the parent order was created (YYYY-MM-DD HH:MM:SS). Add for time-of-day analysis.
Line Item NameProduct/variant name on the line, the shipping method title, or the refund line's product name.
Line Item TypeProduct, Shipping, or Refund.
QuantityQuantity sold (or refunded for refund rows).
Unit PricePer-unit price after line-level discounts (i.e. Total Price / Quantity).
CurrencyCurrency of the line.
Total PriceNet price for the line after discounts. Negative for refund rows.
Refunded AmountAmount refunded for this specific line. Populated on refund rows (positive number, equal to -Total Price); 0 for product and shipping rows. Sum across an order to get the total refunded for that order.
Discount AmountAmount of discount allocated to this specific line.
Discount Codes AppliedComma-separated codes/titles of discounts allocated to this line.
Discount Code IDsComma-separated resolvable catalog discount IDs for this line.
Manual Discount CodesCustomer-typed codes plus admin-applied manual discount titles allocated to this line.
Automatic Discount TitlesTitles of automatic discounts allocated to this line.
Discount Codes Applied (JSON)JSON array form of Discount Codes Applied (good for BigQuery/Apps Script).
Discount Code IDs (JSON)JSON array form of Discount Code IDs.
Discounted PriceEquivalent to Total Price for product/shipping rows; provided for backwards compatibility.
Tax AmountTax allocated to this line.
Tax RateTax rate applied (decimal, e.g. 0.05).
Tax NameTax label (e.g. GST, VAT).
SKUSKU of the variant (also populated on refund rows).
Variant IDNumeric variant ID (also populated on refund rows).
Variant TitleVariant title (e.g. Small / Red).
Product IDNumeric product ID (also populated on refund rows so per-product revenue queries work).
Product TitleProduct title.
Product TypeProduct type/category.
VendorVendor / brand for the product.
Product TagsComma-separated tags from the product (empty for shipping rows).
Order Fulfillment StatusParent order fulfillment status.
Financial StatusParent order financial status (e.g. PAID, REFUNDED, PARTIALLY_REFUNDED).
Line Item Fulfillment StatusPer-line fulfillment status derived from fulfilled vs unfulfilled quantity.
Fulfilled QuantityUnits fulfilled on this line.
Unfulfilled QuantityUnits not yet fulfilled on this line.
Is Gift CardWhether the underlying product is a gift card.
Refundable QuantityQuantity still eligible for refund on this line.
Fulfillment DateOptional. Date the line became fully fulfilled (blank if partial/unfulfilled or for refund rows). Only fetched when this column is selected.
Fulfillment IDOptional. Comma-separated fulfilment names for this line (e.g. #1001.1, #1001.2). Only fetched when selected.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Refund rows currently appear at the end of the Line Items export rather than interleaved with their order's product/shipping rows. Group by Order ID to see all rows for an order together.

Orders + Line Items

One row per line item, shipping line, or refund line, with selected order fields repeated on each row. Use this when you want a single denormalized sheet (order customer, shipping, and status next to each product line) without joining Orders and Line Items yourself. Date range: grain and date filtering match the Line Items tab. Shared identity fields (Order ID, Order Number, Order Date, Currency) are merged into one column; order-level money and line-level money stay separate so you do not double-count when summing. Order totals are available but off by default. Filters (fulfillment, payment status, tags, and so on) use one filter set for the whole tab. See Reconciling Orders and Line Items for refund date behaviour.

ColumnDescription
Order IDShopify's numeric order ID. Same value on every line for that order.
Order NumberCustomer-facing order number (leading # stripped). Same across lines of the same order.
Order DateDate the parent order was created (YYYY-MM-DD).
Order Date TimeFull timestamp the parent order was created (YYYY-MM-DD HH:MM:SS).
Customer IDNumeric Shopify customer ID (blank for guest orders). Repeated from the parent order.
Customer NameCustomer first + last name from the parent order.
Customer EmailCustomer email from the parent order.
Customer PhoneCustomer phone from the parent order.
Customer Address Line 1Customer's current default account address, line 1 (can change over time).
Customer Address Line 2Customer's current default account address, line 2.
Customer CityCustomer's current default account address, city.
Customer Province/StateCustomer's current default account address, province or state.
Customer CountryCustomer's current default account address, country name.
Customer Country CodeISO country code for the customer's current default account address.
Customer Zip/Postal CodeCustomer's current default account address, postal code.
Shipping Address Line 1Ship-to address line 1 as stored on the order at checkout. Repeated on every line of the order.
Shipping Address Line 2Ship-to address line 2 as stored on the order at checkout.
Shipping CityShip-to city as stored on the order at checkout.
Shipping Province/StateShip-to province or state as stored on the order at checkout.
Shipping CountryShip-to country name as stored on the order at checkout.
Shipping Country CodeISO country code for the ship-to address on the order.
Shipping Zip/Postal CodeShip-to postal code as stored on the order at checkout.
Order Fulfillment StatusOrder-level Shopify display fulfillment status (e.g. FULFILLED, UNFULFILLED).
Financial StatusOrder-level payment status (e.g. PAID, REFUNDED).
CurrencyCurrency code for the line (falls back to the order currency when the line has none, e.g. some refund rows).
Order SubtotalCurrent order subtotal after refunds (excludes shipping). Repeated on every line; do not sum across lines.
Order ShippingShipping charged on the order. Repeated on every line; do not sum across lines.
Order TaxesTotal tax on the order. Repeated on every line; do not sum across lines.
Order DiscountsTotal discount amount on the order. Repeated on every line; do not sum across lines.
Order Total PriceCurrent order total after refunds. Repeated on every line; do not sum across lines.
Order Refunded AmountCumulative amount refunded against the order. Repeated on every line; do not sum across lines.
Order Quantity SoldTotal product units on the order. Repeated on every line; do not sum across lines.
Order Discount Codes AppliedComma-separated discount codes/titles applied at the order level.
Order Discount Code IDsComma-separated catalog discount IDs for order-level discounts (when resolvable).
Order Manual Discount CodesCustomer-typed codes plus admin-applied manual discount titles on the order.
Order Automatic Discount TitlesTitles of automatic discounts applied to the order.
Order Discount Codes Applied (JSON)JSON array of order-level discount codes/titles.
Order Discount Code IDs (JSON)JSON array of resolvable order-level catalog discount IDs.
Order TagsComma-separated tags on the parent order.
Order NoteFree-form note on the parent order.
Order Note AttributesJSON array of order custom attributes (key/value pairs).
Order SourceWhere the order came from (e.g. web, pos).
Referring SiteReferrer URL from the customer journey on the order (when available).
Landing SiteLanding page from the customer journey on the order (when available).
Line Item IDShopify's ID for the line item. For refunds this is {refund_id}_{refund_line_item_id}.
Line Item NameProduct/variant name, shipping method title, or refund line product name.
Line Item TypeProduct, Shipping, or Refund.
QuantityQuantity sold (or refunded for refund rows).
Unit PricePer-unit price after line-level discounts (Line Total Price / Quantity).
Line Total PriceNet price for this line after discounts. Negative for refund rows. Safe to sum across rows.
Line Refunded AmountAmount refunded for this line. Populated on refund rows; 0 for product and shipping.
Line Discount AmountDiscount allocated to this specific line.
Line Discount Codes AppliedComma-separated codes/titles of discounts allocated to this line.
Line Discount Code IDsComma-separated resolvable catalog discount IDs for this line.
Line Manual Discount CodesCustomer-typed codes plus admin-applied manual titles allocated to this line.
Line Automatic Discount TitlesTitles of automatic discounts allocated to this line.
Line Discount Codes Applied (JSON)JSON array form of Line Discount Codes Applied.
Line Discount Code IDs (JSON)JSON array form of Line Discount Code IDs.
Discounted PriceEquivalent to Line Total Price for product/shipping rows; kept for compatibility with Line Items.
Tax AmountTax allocated to this line.
Tax RateTax rate applied (decimal, e.g. 0.05).
Tax NameTax label (e.g. GST, VAT).
SKUSKU of the variant (also populated on refund rows).
Variant IDNumeric variant ID.
Variant TitleVariant title (e.g. Small / Red).
Product IDNumeric product ID.
Product TitleProduct title.
Product TypeProduct type/category.
VendorVendor / brand for the product.
Product TagsComma-separated tags from the product on this line (empty for shipping rows).
Line Item Fulfillment StatusPer-line fulfillment status (e.g. FULFILLED, UNFULFILLED, PARTIALLY_FULFILLED, or Refunded).
Fulfilled QuantityUnits fulfilled on this line.
Unfulfilled QuantityUnits still unfulfilled on this line.
Is Gift CardWhether the underlying product is a gift card.
Refundable QuantityQuantity still eligible for refund on this line.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

When summing money, use Line Total Price (and other Line* money columns). Order Total Price and related Order* money columns repeat on every line of a multi-item order.

Product Analysis

Date range: one row per product and currency for the selected export date range by default, or one row per variant (and currency) when One row per variant (SKU / size) is enabled on the Product Analysis tab. Metrics are rolled up from Product and Refund line items only (same pipeline as the Line Items tab: bulk line items plus refund rows). Shipping lines and rows without a product ID are excluded. With Since last export, the same incremental rules apply as for Line Items (order date for product lines; refund processed date for refunds). Rows are sorted by Product ID, then variant ID when that mode is on, then currency.

ColumnDescription
Product IDNumeric Shopify product ID.
Variant IDNumeric Shopify variant ID. Populated when One row per variant is enabled; otherwise blank.
Variant TitleVariant option label (e.g. size). Populated for per-variant rollups; otherwise blank.
SKUVariant SKU when per-variant rollups are enabled; otherwise blank.
Product TitleProduct display title (from the first line seen for that bucket in the window).
Product TypeProduct type / category.
VendorVendor / brand.
CurrencyLine-item shop currency for this bucket (multi-currency stores can produce multiple rows per product or variant).
Gross SalesProduct price × quantity from sales in the window, before discounts and before refunds. Matches Shopify's Sales by product Gross sales.
DiscountsSum of line-level discount amounts on sales (positive number; reduces Net Sales).
ReturnsSum of refunded amounts in the window (positive number; reduces Net Sales).
Net SalesGross Sales − Discounts − Returns. Matches Shopify's Sales by product Net sales.
TaxSum of line tax on sales (refund rows carry no tax in this pipeline).
Total SalesNet Sales + Tax.
Units SoldNet items sold: quantities sold minus quantities refunded.
OrdersCount of distinct Order ID values that include this product or variant (sales or refunds) in the window.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Append is off by default for this tab. See Configuring Shopify exports for date-range and refund behaviour.

Refund Analysis

Date range: one row per product and currency for the selected export date range, only for products with at least one refund in the window — products with sales but no refunds are not included. Combines Product lines (units and gross sales) with Refund lines (refunded units, refund amount, refund line count, distinct orders with a refund). Shipping lines and rows without a product ID are excluded. With Since last export, the same incremental rules apply as for Line Items (order date for product lines; refund processed date for refunds). Rows are sorted by Refund Amount descending so the highest-refund products appear first.

ColumnDescription
Product IDNumeric Shopify product ID.
Product TitleProduct display title (from the first line seen for that product in the window).
Product TypeProduct type / category.
VendorVendor / brand.
CurrencyLine-item shop currency for this bucket when known from product rows (multi-currency stores can produce multiple rows per product).
Units SoldQuantity sold (gross), from Product lines only. Refunds are tracked separately as Refunded Units.
Gross SalesProduct price × quantity from sales in the window, before discounts and before refunds. Same Gross Sales basis as Product Analysis (Shopify Sales by product).
Orders With ProductCount of distinct Order ID values that have at least one product line for this product in the window.
Refunded UnitsSum of absolute quantities on Refund rows.
Refund AmountSum of Refunded Amount on refund rows (positive subtotal refunded).
Refund Line ItemsNumber of refund line-item rows in the window (not the same as refunded units when partial lines refund multiple times).
Orders RefundedCount of distinct Order ID values that have at least one refund line for this product in the window.
Net UnitsUnits Sold − Refunded Units.
Net SalesGross Sales − Discounts − Refund Amount. Matches Shopify's Sales by product Net sales (line discounts on the original sales are subtracted internally even though Discounts is not a column on this tab).
Refund Rate (Units)Refunded Units ÷ Units Sold when units sold > 0; otherwise 0.
Refund Rate ($)Refund Amount ÷ Gross Sales when gross sales > 0; otherwise 0.
Avg Refund ValueRefund Amount ÷ Refund Line Items when there is at least one refund line; otherwise 0.
Avg Refund QuantityRefunded Units ÷ Refund Line Items when there is at least one refund line; otherwise 0.
Avg Days to RefundAverage calendar days between the order createdAt and the refund processed time (Refund Date), over refund lines where both timestamps parse.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Append is off by default for this tab. See Configuring Shopify exports for date-range and refund behaviour.

Refund Line Analysis

Date range: one row per refund line item over the selected export date range, with return reason metadata when the refund came from a Shopify Return. Same refund pipeline as the Line Items tab. With Since last export, refund rows are matched against the refund processed date, so refunds processed in the window are included even when the underlying order was created earlier.

ColumnDescription
Refund Line IDComposite ID combining the Shopify refund ID and the refund line item ID.
Order IDNumeric Shopify order ID.
Order NameShopify order name (e.g. 1001, with the leading # stripped).
Order DateOriginal order creation date (YYYY-MM-DD).
Order Date TimeOriginal order creation timestamp (YYYY-MM-DD HH:MM:SS).
Refund DateRefund processed date.
Line Item NameOriginal line item name from the order.
Refunded QuantityUnits refunded on this refund line.
Refund Price (per unit)Refund Amount divided by Refunded Quantity (0 when quantity is 0).
Refund AmountRefund subtotal in shop currency for this line (positive value).
SKU / Variant ID / Variant TitleOriginal variant identity for the refunded line.
Product ID / Product Title / Product Type / VendorOriginal product identity for the refunded line.
Return ReasonShopify ReturnReason value when a customer-initiated Shopify Return is associated with this refund (e.g. DEFECTIVE, WRONG_ITEM, SIZE_TOO_SMALL, UNWANTED, OTHER). Blank for merchant-initiated refunds without a Return.
Return Reason NoteFree-text note that accompanies the return reason on the Shopify Return.
Customer NoteCustomer-supplied note on the Shopify Return.
Restock TypeShopify RestockType on the refund line: NO_RESTOCK, CANCEL, RETURN, or LEGACY_RESTOCK.
RestockedYes/No — whether the refund line was restocked.
Discount Codes Applied / Manual Discount Codes / Automatic Discount Titles / Discount Codes Applied (JSON)Discount code context inherited from the parent order (refunds don't carry their own discount codes).
Is Gift CardYes/No — whether the refunded product is a gift card.
Date ExportedTimestamp this row was written by SyncRange (your account timezone).

Append is off by default for this tab. Refunds without an associated Shopify Return (e.g. merchant-initiated refunds) leave Return Reason / Note / Customer Note blank but still report Restock Type and Restocked.

Customers

One row per customer. Date range: filtered by customer creation date — customers who only placed orders in the window but were created earlier are not included.

Tip: If the export is taking a long time, remove the customer segment columns from the Customers tab to improve efficiency, unless you need that data. More ideas: Export efficiency tips.

ColumnDescription
Customer IDNumeric Shopify customer ID.
First NameCustomer first name.
Last NameCustomer last name.
EmailCustomer email address.
NotesFree-form notes recorded against the customer.
Customer TagsComma-separated list of tags on the customer (same idea as order tags).
Account Created DatetimeFull timestamp the customer account was created.
Account Created DateDate-only version of Account Created Datetime.
Account Age in DaysDays between account creation and today.
Last Order Created DatetimeTimestamp of the customer's most recent order.
Last Order Created DateDate-only version of the above.
Address Line 1Default shipping/billing address line 1.
Address Line 2Default address line 2.
CityDefault address city.
Province/StateDefault address province or state.
CountryDefault address country name.
Country CodeISO country code.
Zip/Postal CodeDefault address postal code.
Customer Segment IDsComma-separated list of segment IDs the customer belongs to.
Customer Segment NamesComma-separated list of segment names.
Customer Segment IDs (JSON)JSON array variant of Customer Segment IDs.
Customer Segment Names (JSON)JSON array variant of Customer Segment Names.
Date ExportedTimestamp this row was written by SyncRange.

You can also add up to 8 customer metafield columns (e.g. custom.loyalty_tier) — see Customer metafield columns.

Customer Segments

One row per (segment, customer) membership across every segment in the store. Full export each run: always current membership; the date range does not apply. Use Customer ID to join back to the Customers tab; Shopify does not return email on segment member rows.

ColumnDescription
Segment IDNumeric ID of the segment.
Segment NameDisplay name of the segment.
Customer IDNumeric customer ID for the membership.
Customer Display NameBest-available display name for the customer.
First NameCustomer first name.
Last NameCustomer last name.
Number of OrdersTotal orders for the customer at the time of export.
Amount SpentCustomer lifetime spend.
Amount Spent CurrencyCurrency code for Amount Spent.
Date ExportedTimestamp this row was written by SyncRange.

Discounts

One row per discount code. Automatic discounts (no code) emit a single row with blank code fields. Full export each run: always current discount catalog; the date range does not apply.

ColumnDescription
Discount IDNumeric ID of the discount in Shopify's catalog.
Discount TypeType of discount (e.g. code, automatic).
Discount TitleTitle given to the discount in Shopify admin.
Discount SummaryHuman-readable summary (e.g. "10% off all products").
StatusDiscount status (e.g. ACTIVE, EXPIRED, SCHEDULED).
Discount CodeThe code customers enter (blank for automatic discounts).
Total Used CountTotal times this discount has been used (across all codes for the same discount).
Code Used CountTimes this specific code has been used.
Limit Total TimesMaximum total uses configured (blank if unlimited).
Limit One Use Per CustomerWhether use is limited to once per customer.
Starts AtDatetime the discount becomes active.
Ends AtDatetime the discount stops being active (blank if no end).
Created AtDatetime the discount was created.
Updated AtDatetime the discount was last modified.
Discount Value TypeWhether the value is percentage or fixed amount.
Discount ValueThe discount value (e.g. 10 for 10% or 10 currency units).
Value CurrencyCurrency code when the value is a fixed amount.
Minimum Purchase TypeType of minimum-purchase requirement (e.g. quantity vs subtotal).
Minimum ValueThreshold value for the minimum-purchase requirement.
Eligibility TypeWho the discount applies to (e.g. all customers, specific segments).
Eligibility ValuesComma-separated list of eligibility values (segment names, customer IDs, etc).
Eligibility Customer Segment IDsComma-separated segment IDs the discount is restricted to.
Eligibility Customer Segment NamesComma-separated segment names the discount is restricted to.
Eligibility Customer Segment IDs (JSON)JSON array variant of the segment IDs above.
Eligibility Customer Segment Names (JSON)JSON array variant of the segment names above.
Combines With Order DiscountsWhether this stacks with other order-level discounts.
Combines With Product DiscountsWhether this stacks with product-level discounts.
Combines With Shipping DiscountsWhether this stacks with shipping discounts.
Discount URLShareable Shopify discount URL (when available).
Date ExportedTimestamp this row was written by SyncRange.

Payouts

One row per Shopify Payments bank transfer. Date range: filtered by issued_at; supports Since last export. Requires Shopify Payments and the read_shopify_payments_accounts and read_shopify_payments_payouts OAuth scopes — see Shopify Payments exports.

ColumnDescription
Payout IDNumeric Shopify payout ID (bank transfer reference).
Payout DateDatetime the payout was issued to your bank account.
StatusPayout status (e.g. PAID, SCHEDULED, FAILED).
TypeTransfer direction (e.g. DEPOSIT to your bank, WITHDRAWAL back to Shopify Payments).
Net AmountNet amount transferred in this payout.
CurrencyCurrency code for the payout (ISO 4217).
Charges GrossTotal gross amount from charges included in this payout.
Charges FeeTotal processing fees from charges included in this payout.
Refunds GrossTotal gross amount from refunds included in this payout.
Refunds FeeTotal processing fees from refunds included in this payout.
Adjustments GrossTotal gross amount from adjustments (including disputes) in this payout.
Adjustments FeeTotal fees from adjustments in this payout.
Date ExportedTimestamp this row was written by SyncRange.

Balance Transactions

One row per Shopify Payments ledger entry (charge, refund, adjustment, etc.). Date range: filtered by processed_at; supports Since last export. This is the source of truth for per-transaction processing fees and links to orders and payouts. Requires Shopify Payments and the read_shopify_payments_accounts and read_shopify_payments_payouts scopes.

ColumnDescription
Balance Transaction IDNumeric ID of the balance transaction.
Transaction DateDatetime the transaction was processed.
TypeTransaction type (e.g. CHARGE, REFUND, ADJUSTMENT).
Source TypeSource category for the transaction (e.g. charge, refund, payout).
TestWhether this was a test transaction.
Order IDNumeric order ID when the transaction is linked to an order. Use to join to the Orders tab.
Order NumberCustomer-facing order number when linked to an order.
Payout IDNumeric payout ID when this transaction is included in a bank transfer. Use to join to the Payouts tab.
Payout StatusStatus of the associated payout (when present).
Gross AmountGross amount for this transaction (before processing fees).
Fee AmountShopify Payments processing fee for this transaction — the per-transaction platform charge.
Net AmountNet amount credited or debited after the processing fee.
CurrencyCurrency code (ISO 4217).
Source IDID of the underlying resource (e.g. order transaction) that created this balance entry.
Source Order Transaction IDOrder transaction ID when applicable.
Adjustment ReasonReason for adjustment-type transactions (blank for charges and refunds).
Date ExportedTimestamp this row was written by SyncRange.

Join to the Orders tab on Order ID for per-order fee analysis.

Inventory (cost)

One row per inventory item, with cost and value. Full export each run: always current inventory; the date range does not apply.

ColumnDescription
Inventory Item IDNumeric ID of the inventory item.
Variant IDVariant ID this inventory item belongs to.
Product IDProduct ID this inventory item belongs to.
Product TitleProduct display title.
Variant TitleVariant display title.
SKUStock Keeping Unit.
QuantityTotal quantity tracked for this inventory item across locations.
Cost per ItemUnit cost configured in Shopify.
CurrencyCurrency code for cost values.
Total ValueQuantity × Cost per Item.
TrackedWhether inventory is tracked for this item.
Country of OriginCountry where the item was produced.
Province of OriginProvince / state of origin (where applicable).
HS CodeHarmonized System tariff classification code.
Product TypeProduct type/category.
VendorVendor / brand.
Date ExportedTimestamp this row was written by SyncRange.

Inventory by Location

Inventory broken down per location — one row per (inventory item, location). Full export each run: always current stock by location; the date range does not apply.

ColumnDescription
Inventory Item IDNumeric ID of the inventory item.
SKUStock Keeping Unit.
TrackedWhether inventory is tracked for this item.
Variant IDVariant ID associated with the inventory item.
Variant TitleVariant display title.
Variant PriceSelling price for the variant.
Product IDProduct ID for the variant.
Product TitleProduct display title.
Product TypeProduct type/category.
VendorVendor / brand.
Location IDNumeric ID of the location.
Location NameDisplay name of the location.
QuantityQuantity available at this location.
Date ExportedTimestamp this row was written by SyncRange.

Locations

Store locations and fulfillment centers. Full export each run: always current locations; the date range does not apply.

ColumnDescription
Location IDNumeric Shopify location ID.
Location NameDisplay name of the location.
Address Line 1Street address line 1.
Address Line 2Street address line 2.
CityCity.
Province/StateProvince or state.
Zip/Postal CodePostal code.
CountryCountry name.
Country CodeISO country code.
PhonePhone number.
Is ActiveWhether the location is active.
Fulfills Online OrdersWhether the location fulfills online orders.
Has Active InventoryWhether the location has any inventory tracked.
Ships InventoryWhether the location ships inventory.
Date ExportedTimestamp this row was written by SyncRange.

Collections

One row per collection. Full export each run: always current collections; the date range does not apply. Optional collection metafields can be added — see Collection metafield columns.

ColumnDescription
Collection IDNumeric collection ID.
TitleCollection display title.
HandleURL-safe collection handle.
DescriptionCollection description (HTML stripped).
Sort OrderConfigured sort order for the collection.
Products CountNumber of products in the collection.
Updated AtTimestamp the collection was last modified.
Date ExportedTimestamp this row was written by SyncRange.

Store

A single row of store-level information. Full export each run: always current store settings; the date range does not apply.

ColumnDescription
Store IDNumeric Shopify shop ID.
Store NamePublic store name.
Store EmailPrimary store email address.
Store DomainThe *.myshopify.com domain.
Primary DomainThe customer-facing primary domain.
Plan NameShopify plan (e.g. basic, shopify, advanced, plus).
Shopify PlusWhether the store is on Shopify Plus.
CurrencyDefault store currency code.
CountryStore address country name.
CityStore address city.
Zip/Postal CodeStore address postal code.
Contact EmailCustomer-facing contact email.
Customer AccountsCustomer-account configuration setting (e.g. optional, required).
Taxes IncludedWhether prices include tax in admin.
Tax ShippingWhether shipping is taxed.
Has Gift CardsWhether the store sells gift cards.
Has International DomainsWhether the store has international/markets domains.
Date ExportedTimestamp this row was written by SyncRange.

Sales Metrics

One row per order with derived sales metrics matching Shopify's reports view. Date range: filtered by order creation date.

ColumnDescription
Order IDNumeric order ID.
Order NumberCustomer-facing order number.
Order DateDate the order was created.
Customer NameCustomer first + last name.
Gross SalesSum of line item original prices before discounts and refunds.
DiscountsTotal discount allocated to the order (negative impact on net sales).
ReturnsTotal refunded subtotal for line items returned.
Net SalesGross Sales − Discounts − Returns.
ShippingShipping charged on the order.
TaxTax collected on the order.
DutiesDuties collected on the order.
Total SalesNet Sales + Shipping + Tax + Duties.
CurrencyOrder currency code.
Payment MethodBuyer-facing method when available (e.g. Visa, PayPal, Apple Pay). Blank when Shopify does not provide payment details.
Payment GatewayShopify payment gateway name(s) (e.g. shopify_payments, paypal). Blank when none.
Fulfillment StatusOrder fulfillment status.
Financial StatusOrder financial status.
Date ExportedTimestamp this row was written by SyncRange.

Analytics (ShopifyQL)

Aggregated Shopify Analytics reports via ShopifyQL. In the exporter UI these are grouped into six tabs with selectable breakdowns; each breakdown still writes its own destination table. Require the read_reports scope. Date range: all Analytics tabs use the export date range. These tabs do not duplicate Orders, Sales Metrics, Product Analysis, or other entity-level exports.

Analytics Sessions Daily

Daily online store sessions, visitors, funnel, and conversion metrics. Filtered by the export date range.

ColumnDescription
Dateday
Sessionssessions
Visitorsonline_store_visitors
Pageviewspageviews
Pageviews Per Sessionpageviews_per_session
Avg Session Duration (sec)average_session_duration
Bouncesbounces
Bounce Ratebounce_rate
Sessions With Cart Additionssessions_with_cart_additions
Added To Cart Rateadded_to_cart_rate
Sessions Reached Checkoutsessions_that_reached_checkout
Reached Checkout Ratereached_checkout_rate
Sessions Completed Checkoutsessions_that_completed_checkout
Conversion Rateconversion_rate
Checkout Conversion Ratecheckout_conversion_rate
Date ExportedexportDate

Analytics Sessions by Source

Daily sessions broken down by referrer channel and UTM. Filtered by the export date range.

ColumnDescription
Dateday
Referrer Sourcereferrer_source
Referring Channelreferring_channel
Referring Mediumreferring_medium
UTM Sourceutm_source
UTM Mediumutm_medium
UTM Campaignutm_campaign
Sessionssessions
Visitorsonline_store_visitors
Pageviewspageviews
Pageviews Per Sessionpageviews_per_session
Avg Session Duration (sec)average_session_duration
Bouncesbounces
Bounce Ratebounce_rate
Sessions With Cart Additionssessions_with_cart_additions
Added To Cart Rateadded_to_cart_rate
Sessions Reached Checkoutsessions_that_reached_checkout
Reached Checkout Ratereached_checkout_rate
Sessions Completed Checkoutsessions_that_completed_checkout
Conversion Rateconversion_rate
Checkout Conversion Ratecheckout_conversion_rate
Date ExportedexportDate

Analytics Sessions by Landing Page

Daily sessions broken down by landing page path and type. Filtered by the export date range.

ColumnDescription
Dateday
Landing Page Pathlanding_page_path
Landing Page Typelanding_page_type
Sessionssessions
Visitorsonline_store_visitors
Pageviewspageviews
Pageviews Per Sessionpageviews_per_session
Avg Session Duration (sec)average_session_duration
Bouncesbounces
Bounce Ratebounce_rate
Sessions With Cart Additionssessions_with_cart_additions
Added To Cart Rateadded_to_cart_rate
Sessions Reached Checkoutsessions_that_reached_checkout
Reached Checkout Ratereached_checkout_rate
Sessions Completed Checkoutsessions_that_completed_checkout
Conversion Rateconversion_rate
Checkout Conversion Ratecheckout_conversion_rate
Date ExportedexportDate

Analytics Sessions by Device

Daily sessions broken down by device type, browser, and OS. Filtered by the export date range.

ColumnDescription
Dateday
Device Typesession_device_type
Browsersession_device_browser
Operating Systemsession_device_os
Sessionssessions
Visitorsonline_store_visitors
Pageviewspageviews
Pageviews Per Sessionpageviews_per_session
Avg Session Duration (sec)average_session_duration
Bouncesbounces
Bounce Ratebounce_rate
Sessions With Cart Additionssessions_with_cart_additions
Added To Cart Rateadded_to_cart_rate
Sessions Reached Checkoutsessions_that_reached_checkout
Reached Checkout Ratereached_checkout_rate
Sessions Completed Checkoutsessions_that_completed_checkout
Conversion Rateconversion_rate
Checkout Conversion Ratecheckout_conversion_rate
Date ExportedexportDate

Analytics Sessions by Country

Daily sessions broken down by visitor country and region. Filtered by the export date range.

ColumnDescription
Dateday
Countrysession_country
Country Codesession_country_code
Regionsession_region
Sessionssessions
Visitorsonline_store_visitors
Pageviewspageviews
Pageviews Per Sessionpageviews_per_session
Avg Session Duration (sec)average_session_duration
Bouncesbounces
Bounce Ratebounce_rate
Sessions With Cart Additionssessions_with_cart_additions
Added To Cart Rateadded_to_cart_rate
Sessions Reached Checkoutsessions_that_reached_checkout
Reached Checkout Ratereached_checkout_rate
Sessions Completed Checkoutsessions_that_completed_checkout
Conversion Rateconversion_rate
Checkout Conversion Ratecheckout_conversion_rate
Date ExportedexportDate

Analytics Campaign Sales

Daily campaign-attributed sales and orders across Shopify attribution models. Filtered by the export date range.

ColumnDescription
Dateday
Campaign IDcampaign_id
Last Click Orderscampaign_last_click_order_count
Last Click Salescampaign_last_click_total_sales
Last Click AOVcampaign_last_click_total_average_order_value
Last Non-Direct Click Orderscampaign_last_non_direct_click_order_count
Last Non-Direct Click Salescampaign_last_non_direct_click_total_sales
First Click Orderscampaign_first_click_order_count
First Click Salescampaign_first_click_total_sales
Linear Orderscampaign_linear_order_count
Linear Salescampaign_linear_total_sales
Date ExportedexportDate

Analytics Campaign Sessions

Daily session and funnel metrics for marketing campaign traffic. Filtered by the export date range.

ColumnDescription
Dateday
Campaign IDcampaign_id
Sessionscampaign_sessions
Visitorscampaign_online_store_visitors
Pageviewscampaign_pageviews
Bounce Ratecampaign_bounce_rate
Sessions With Cart Additionscampaign_sessions_with_cart_additions
Sessions Reached Checkoutcampaign_sessions_that_reached_checkout
Sessions Completed Checkoutcampaign_sessions_that_completed_checkout
Conversion Ratecampaign_conversion_rate
Date ExportedexportDate

Analytics Marketing Engagements

Channel-reported marketing spend, impressions, clicks, and sales for the export date range (one row per marketing activity; this schema has no daily breakdown).

ColumnDescription
Marketing Activity IDmarketing_activity_id
Marketing Activity Titlemarketing_activity_title
Channelchannel_handle
Platformmarketing_platform
Ad Spendengagements_ad_spend
Impressionsengagements_impressions
Clicksengagements_clicks
Unique Clicksengagements_unique_clicks
Sendsengagements_sends
Orders (Channel-Reported)engagements_orders
Sales (Channel-Reported)engagements_total_sales
First-Time Customersengagements_first_time_customers
Returning Customersengagements_returning_customers
Unsubscribesengagements_unsubscribes
Date ExportedexportDate

Analytics Search Queries

Daily on-site search query volume and intent. Filtered by the export date range.

ColumnDescription
Dateday
Search Querysearch_query
Search Intentsearch_query_intent
Results Returnedsearch_results_were_returned
Searchessearches
Date ExportedexportDate

Analytics Search Conversions

Daily on-site search funnel from search to purchase. Filtered by the export date range.

ColumnDescription
Dateday
Sessions With Searchessessions_with_searches
Search Sessions With Clickssearch_sessions_with_clicks
Search Click Ratesearch_click_rate
Search Sessions With Cart Additionssearch_sessions_with_cart_additions
Search Added To Cart Ratesearch_added_to_cart_rate
Search Sessions Completed Checkoutsearch_sessions_that_completed_checkout
Search Conversion Ratesearch_conversion_rate
Date ExportedexportDate

Analytics Web Performance

Daily Core Web Vitals and page load metrics by page type and device. Filtered by the export date range.

ColumnDescription
Dateday
Page Typepage_type
Device Typedevice_type
Page Loadspage_loads
LCP p75 (ms)lcp_p75_ms
LCP Good Viewslcp_good_view_count
LCP Poor Viewslcp_poor_view_count
CLS Good Viewscls_good_view_count
CLS Poor Viewscls_poor_view_count
INP p75 (ms)inp_p75_ms
INP Poor Viewsinp_poor_view_count
TTFB p75 (ms)ttfb_p75_ms
FCP p75 (ms)fcp_p75_ms
Date ExportedexportDate

Analytics Shop Campaign Insights

Daily Shop Campaign sales, ad spend, ROAS, and acquisition cost. Filtered by the export date range.

ColumnDescription
Dateday
Shop Campaign Nameshop_campaign_name
Target Segmentshop_campaign_target_name
Salesshop_campaign_sales
Ad Spendshop_campaign_ad_spend
ROASshop_campaign_return_on_ad_spend
Avg CACshop_campaign_average_customer_acquisition_cost
Customersshop_campaign_customers
AOVshop_campaign_average_order_value
Date ExportedexportDate

Related Documentation

Something missing on this page? Email [email protected]

Start syncing your ecommerce data in minutes Start free today. No credit card required.