> For the complete documentation index, see [llms.txt](https://help.littledata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.littledata.io/event-editor/glossary.md).

# Tracking schema glossary

Use this glossary to look up the fields and objects available in the Event Editor.

Each section renders from the live OpenAPI specification.

That keeps this reference in sync with the event pipeline.

### Properties

Top-level event properties. The fields available depend on the event type.

## The properties object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"properties":{"type":"object","description":"Top-level event properties. The fields available depend on the event type. This object lists every property that can appear under properties across all supported events.","properties":{"create_checkout_url":{"type":"string","format":"uri","description":"URL that recreates the items in this event as a new cart and checkout when opened"},"id":{"type":"string","description":"ID of the underlying Shopify resource for this event"},"note":{"type":"string","description":"Customer note attached to the cart"},"abandoned_checkout_url":{"type":"string","format":"uri","description":"Shopify URL to resume an abandoned checkout (valid for 3 months)"},"cart_id":{"type":"string","description":"Shopify cart ID (cart token) this checkout or order originated from"},"email":{"type":"string","format":"email","description":"Customer email associated with the checkout"},"landing_site":{"type":"string","description":"The landing site URL that led to the checkout"},"payment_gateway":{"type":"string","description":"Payment gateway used at checkout, e.g. shopify_payments"},"phone":{"type":"string","description":"Customer phone number associated with the checkout"},"token":{"type":"string","description":"Shopify checkout token identifying this checkout session"},"first_name":{"type":"string","description":"Customer first name"},"last_name":{"type":"string","description":"Customer last name"},"presentment_currency":{"type":"string","description":"Currency the customer is shown prices in, e.g. EUR"},"state":{"type":"string","description":"Customer account state (enabled/disabled/invited/declined)"},"tax_exempt":{"type":"number","format":"float","description":"Whether the customer is tax exempt"},"tax_exemptions":{"type":"number","format":"float","description":"Shopify tax exemption codes applied to the customer (array)"},"verified_email":{"type":"boolean","description":"Whether the customer has verified their email"},"location_id":{"type":"string","description":"Shopify location ID where the order was processed, mainly set for POS orders"},"name":{"type":"string","description":"Fulfillment name, order name plus fulfillment number, e.g. #1001.1"},"order_id":{"type":"string","description":"Shopify order ID this fulfillment or refund belongs to"},"order_name":{"type":"string","description":"Order name (e.g. #1001)"},"order_number":{"type":"string","description":"Order number as displayed to the customer, e.g. 1001"},"order_type":{"type":"string","description":"Littledata order classification: REGULAR (one-off), FIRST_RECURRING (first subscription order) or RECURRING (subscription renewal)"},"service":{"type":"string","description":"Fulfillment service handling the shipment, e.g. manual or a fulfillment app"},"shipment_status":{"type":"string","description":"Shipment tracking status, e.g. in_transit, out_for_delivery or delivered"},"status":{"type":"string","description":"Subscription status, e.g. active, paused or cancelled"},"tracking_company":{"type":"string","description":"Shipping carrier name, e.g. DHL or UPS"},"tracking_numbers":{"type":"string","description":"Tracking numbers (array)"},"tracking_urls":{"type":"string","format":"uri","description":"Tracking URLs (array)"},"checkout_id":{"type":"string","description":"Shopify checkout ID this order or refund originated from"},"checkout_token":{"type":"string","description":"Shopify checkout token the order originated from"},"fulfillment_status":{"type":"string","description":"Order fulfillment status, e.g. fulfilled, partial or unfulfilled"},"import":{"type":"boolean","description":"Whether this is an imported (historical) order"},"order_status_url":{"type":"string","format":"uri","description":"Shopify order status page URL"},"payment_gateways":{"type":"string","description":"Payment gateways used on the order (array), e.g. shopify_payments, gift_card"},"tags":{"type":"array","items":{"type":"string"},"description":"Order tags"},"cancel_reason":{"type":"string","description":"Shopify cancellation reason: customer, fraud, inventory, declined or other"},"cancelled_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the order was cancelled"},"return_id":{"type":"string","description":"Shopify return ID linked to this refund, if the refund came from a return"},"user_id":{"type":"string","description":"Shopify staff user ID that issued the refund"},"order_interval_frequency":{"type":"string","description":"Number of interval units between subscription orders, e.g. 30 (used with order_interval_unit)"},"order_interval_unit":{"type":"string","description":"Unit of the subscription billing interval, e.g. day, week or month"},"subscription_id":{"type":"string","description":"Subscription contract ID from the subscription app"},"cancel_reason_comments":{"type":"string","description":"Free-text comments left by the customer when cancelling"},"error_type":{"type":"string","description":"Subscription charge failure type, e.g. card declined"}}}}}}
```

### Event

Event-level metadata such as timestamp, event name, and identifiers.

## The event object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"event":{"type":"object","description":"Event-level metadata such as timestamp, event name, and identifiers.","properties":{"app_id":{"type":"string","description":"ID of the Shopify app that generated this event"},"is_subscription_app":{"type":"boolean","description":"Whether the event was generated by a known subscription app, e.g. Recharge or Skio"},"app_name":{"type":"string","description":"Name of the Shopify app that generated this event"},"source_name":{"type":"string","description":"Shopify source_name of the event, e.g. web, pos, or an app identifier"},"created_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the event was created"},"id":{"type":"string","description":"Unique identifier for this event"},"timestamp":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the event was received by Littledata"}}}}}}
```

### Product

Enriched product object. Represents a product line item in a cart, order, or product event.

## The products object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"products":{"type":"object","description":"Enriched product object (IUTSEnrichedProduct). Represents a product line item in a cart, order, or product event.","properties":{"body_html":{"type":"string","description":"Product description HTML"},"category":{"type":"string","description":"Shopify standard product taxonomy category"},"collections":{"type":"array","items":{"type":"string"},"description":"Collections the product belongs to"},"compare_at_price.presentment":{"type":"number","format":"float","description":"Compare-at price in presentment currency"},"compare_at_price.shop":{"type":"number","format":"float","description":"Compare-at price in shop currency"},"currency.conversion_rate":{"type":"number","description":"Conversion rate from shop currency to presentment currency"},"currency.presentment":{"type":"string","description":"Presentment currency code"},"currency.shop":{"type":"string","description":"Shop currency code"},"discounted_price.presentment":{"type":"number","format":"float","description":"Discounted unit price in presentment currency"},"discounted_price.shop":{"type":"number","format":"float","description":"Discounted unit price in shop currency"},"discounts.amount.presentment":{"type":"number","format":"float","description":"Discount amount in presentment currency"},"discounts.amount.shop":{"type":"number","format":"float","description":"Discount amount in shop currency"},"discounts.title":{"type":"string","description":"Discount title"},"gift_card":{"type":"boolean","description":"Whether the product is a gift card"},"grams":{"type":"integer","description":"Product weight in grams"},"handle":{"type":"string","description":"Product URL handle (slug), e.g. blue-t-shirt"},"image_url":{"type":"string","format":"uri","description":"Product image URL"},"images.alt":{"type":"string","description":"Image alt text"},"images.height":{"type":"integer","description":"Image height"},"images.id":{"type":"string","description":"Image ID"},"images.position":{"type":"integer","description":"Image position"},"images.product_id":{"type":"string","description":"Image product ID"},"images.src":{"type":"string","format":"uri","description":"Image source URL"},"images.thumb_src":{"type":"string","format":"uri","description":"Image thumbnail URL"},"images.variant_ids":{"type":"array","items":{"type":"string"},"description":"Variant IDs associated with the image"},"images.width":{"type":"integer","description":"Image width"},"line_price.presentment":{"type":"number","format":"float","description":"Line price (price * quantity) in presentment currency"},"line_price.shop":{"type":"number","format":"float","description":"Line price (price * quantity) in shop currency"},"name":{"type":"string","description":"Product title + variant title"},"options.id":{"type":"string","description":"Product option ID"},"options.name":{"type":"string","description":"Product option name"},"options.position":{"type":"integer","description":"Product option position"},"options.product_id":{"type":"string","description":"Product option product ID"},"options.values":{"type":"array","items":{"type":"string"},"description":"Product option values"},"price.presentment":{"type":"number","format":"float","description":"Unit price in presentment currency"},"price.shop":{"type":"number","format":"float","description":"Unit price in shop currency"},"product_id":{"type":"string","description":"Shopify product ID"},"product_identifier":{"type":"string","description":"Product identifier field (SKU, variant ID or product ID) as configured in the destination settings"},"product_type":{"type":"string","description":"Product type set in Shopify admin, e.g. T-shirt"},"product_url":{"type":"string","format":"uri","description":"Product URL"},"profit_margin_applied":{"type":"number","format":"float","description":"Profit margin percentage applied to this product (e.g. 0.40 for 40%)"},"profit_value.presentment":{"type":"number","format":"float","description":"Profit value in presentment currency: (price - total discounts - tax) × quantity × margin"},"profit_value.shop":{"type":"number","format":"float","description":"Profit value in shop currency: (price - total discounts - tax) × quantity × margin"},"properties":{"type":"object","description":"Custom line item properties added at the cart (key/value pairs, e.g. engraving text)"},"quantity":{"type":"integer","description":"Number of units of this variant in the line item"},"sku":{"type":"string","description":"Variant SKU (stock keeping unit)"},"tags":{"type":"array","items":{"type":"string"},"description":"Product tags"},"taxable":{"type":"boolean","description":"Whether the product is taxable"},"title":{"type":"string","description":"Product title"},"total_discounts.presentment":{"type":"number","format":"float","description":"Line-total discount in presentment currency"},"total_discounts.shop":{"type":"number","format":"float","description":"Line-total discount in shop currency"},"variant_id":{"type":"string","description":"Shopify variant ID"},"variant_options":{"type":"array","items":{"type":"string"},"description":"Selected option values for the variant, e.g. Size: M, Colour: Blue"},"variant_requires_shipping":{"type":"boolean","description":"Whether the variant requires shipping"},"variant_title":{"type":"string","description":"Variant title"},"vendor":{"type":"string","description":"Product vendor (brand) set in Shopify"},"destination_location_id":{"type":"string","description":"Shopify inventory location ID the items ship to (only populated on checkout events)"},"metafields":{"type":"object","description":"Shopify metafields, keyed by namespace and key"},"origin_location_id":{"type":"string","description":"Shopify inventory location ID the items ship from (only populated on checkout events)"},"rank":{"type":"integer","description":"Position of the line item within the checkout, starting at 1 (only populated on checkout events)"},"tax.presentment":{"type":"number","format":"float","description":"Line-total tax bundled into price, in presentment currency"},"tax.shop":{"type":"number","format":"float","description":"Line-total tax bundled into price, in shop currency"},"tax_line.position":{"type":"integer","description":"Tax line position (only populated on checkout events)"},"tax_line.price":{"type":"number","format":"float","description":"Tax line amount (only populated on checkout events)"},"tax_line.rate":{"type":"number","format":"float","description":"Tax line rate as a decimal, e.g. 0.2 for 20% (only populated on checkout events)"},"tax_line.title":{"type":"string","description":"Tax line title, e.g. VAT (only populated on checkout events)"},"unit_price_measurement.measured_type":{"type":"string","description":"Unit price measurement type, e.g. VOLUME or WEIGHT (only populated on checkout events)"},"unit_price_measurement.quantity_unit":{"type":"string","description":"Unit of the quantity being sold, e.g. ml (only populated on checkout events)"},"unit_price_measurement.quantity_value":{"type":"number","description":"Quantity value being sold, e.g. 500 (only populated on checkout events)"},"unit_price_measurement.reference_unit":{"type":"string","description":"Reference unit for the unit price, e.g. l (only populated on checkout events)"},"unit_price_measurement.reference_value":{"type":"number","description":"Reference value for the unit price, e.g. 1 (only populated on checkout events)"}}}}}}
```

### Cart context

Cart-level context associated with the event.

## The cart\_context object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"cart_context":{"type":"object","description":"Products in the cart at the time of the event. Present on add to cart and remove from cart events alongside the individual product being added or removed.","properties":{"body_html":{"type":"string","description":"Product description HTML"},"category":{"type":"string","description":"Shopify standard product taxonomy category"},"collections":{"type":"array","items":{"type":"string"},"description":"Collections the product belongs to"},"compare_at_price.presentment":{"type":"number","format":"float","description":"Compare-at price in presentment currency"},"compare_at_price.shop":{"type":"number","format":"float","description":"Compare-at price in shop currency"},"currency.conversion_rate":{"type":"number","description":"Conversion rate from shop currency to presentment currency"},"currency.presentment":{"type":"string","description":"Presentment currency code"},"currency.shop":{"type":"string","description":"Shop currency code"},"discounted_price.presentment":{"type":"number","format":"float","description":"Discounted unit price in presentment currency"},"discounted_price.shop":{"type":"number","format":"float","description":"Discounted unit price in shop currency"},"discounts.amount.presentment":{"type":"number","format":"float","description":"Discount amount in presentment currency"},"discounts.amount.shop":{"type":"number","format":"float","description":"Discount amount in shop currency"},"discounts.title":{"type":"string","description":"Discount title"},"gift_card":{"type":"boolean","description":"Whether the product is a gift card"},"grams":{"type":"integer","description":"Product weight in grams"},"handle":{"type":"string","description":"Product URL handle (slug), e.g. blue-t-shirt"},"image_url":{"type":"string","format":"uri","description":"Product image URL"},"images.alt":{"type":"string","description":"Image alt text"},"images.height":{"type":"integer","description":"Image height"},"images.id":{"type":"string","description":"Image ID"},"images.position":{"type":"integer","description":"Image position"},"images.product_id":{"type":"string","description":"Image product ID"},"images.src":{"type":"string","format":"uri","description":"Image source URL"},"images.thumb_src":{"type":"string","format":"uri","description":"Image thumbnail URL"},"images.variant_ids":{"type":"array","items":{"type":"string"},"description":"Variant IDs associated with the image"},"images.width":{"type":"integer","description":"Image width"},"line_price.presentment":{"type":"number","format":"float","description":"Line price (price * quantity) in presentment currency"},"line_price.shop":{"type":"number","format":"float","description":"Line price (price * quantity) in shop currency"},"name":{"type":"string","description":"Product title + variant title"},"options.id":{"type":"string","description":"Product option ID"},"options.name":{"type":"string","description":"Product option name"},"options.position":{"type":"integer","description":"Product option position"},"options.product_id":{"type":"string","description":"Product option product ID"},"options.values":{"type":"array","items":{"type":"string"},"description":"Product option values"},"price.presentment":{"type":"number","format":"float","description":"Unit price in presentment currency"},"price.shop":{"type":"number","format":"float","description":"Unit price in shop currency"},"product_id":{"type":"string","description":"Shopify product ID"},"product_identifier":{"type":"string","description":"Product identifier field (SKU, variant ID or product ID) as configured in the destination settings"},"product_type":{"type":"string","description":"Product type set in Shopify admin, e.g. T-shirt"},"product_url":{"type":"string","format":"uri","description":"Product URL"},"profit_margin_applied":{"type":"number","format":"float","description":"Profit margin percentage applied to this product (e.g. 0.40 for 40%)"},"profit_value.presentment":{"type":"number","format":"float","description":"Profit value in presentment currency: (price - total discounts - tax) × quantity × margin"},"profit_value.shop":{"type":"number","format":"float","description":"Profit value in shop currency: (price - total discounts - tax) × quantity × margin"},"properties":{"type":"object","description":"Custom line item properties added at the cart (key/value pairs, e.g. engraving text)"},"quantity":{"type":"integer","description":"Number of units of this variant in the line item"},"sku":{"type":"string","description":"Variant SKU (stock keeping unit)"},"tags":{"type":"array","items":{"type":"string"},"description":"Product tags"},"taxable":{"type":"boolean","description":"Whether the product is taxable"},"title":{"type":"string","description":"Product title"},"total_discounts.presentment":{"type":"number","format":"float","description":"Line-total discount in presentment currency"},"total_discounts.shop":{"type":"number","format":"float","description":"Line-total discount in shop currency"},"variant_id":{"type":"string","description":"Shopify variant ID"},"variant_options":{"type":"array","items":{"type":"string"},"description":"Selected option values for the variant, e.g. Size: M, Colour: Blue"},"variant_requires_shipping":{"type":"boolean","description":"Whether the variant requires shipping"},"variant_title":{"type":"string","description":"Variant title"},"vendor":{"type":"string","description":"Product vendor (brand) set in Shopify"}}}}}}
```

### Customer

Customer object representing the shopper associated with the event.

## The customer object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"customer":{"type":"object","description":"Customer object representing the shopper associated with the event.","properties":{"address.address1":{"type":"string","description":"Customer Address line 1"},"address.address2":{"type":"string","description":"Customer Address line 2"},"address.city":{"type":"string","description":"Customer Address City"},"address.country":{"type":"string","description":"Customer Address Country"},"address.country_code":{"type":"string","description":"Customer address country as a two-letter ISO code, e.g. US"},"address.province":{"type":"string","description":"Customer Address Province"},"address.province_code":{"type":"string","description":"Customer address province/state code, e.g. CA"},"address.zip":{"type":"string","description":"Customer Address ZIP"},"created_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the customer account was created"},"email":{"type":"string","format":"email","description":"Customer Email"},"email_marketing_consent.consent_updated_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the customer last changed their email marketing consent"},"email_marketing_consent.opt_in_level":{"type":"string","description":"Shopify email marketing opt-in level: SINGLE_OPT_IN, CONFIRMED_OPT_IN or UNKNOWN"},"email_marketing_consent.state":{"type":"string","description":"Email marketing consent state, e.g. SUBSCRIBED, NOT_SUBSCRIBED or UNSUBSCRIBED"},"first_name":{"type":"string","description":"Customer First name"},"id":{"type":"string","description":"Shopify customer ID"},"last_name":{"type":"string","description":"Customer Last name"},"note":{"type":"string","description":"Customer Note"},"orders_count":{"type":"integer","description":"Customer's total number of orders"},"phone":{"type":"string","description":"Customer phone number in E.164 format, e.g. +16135551111"},"sms_marketing_consent.consent_updated_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the customer last changed their SMS marketing consent"},"sms_marketing_consent.opt_in_level":{"type":"string","description":"Shopify SMS marketing opt-in level: SINGLE_OPT_IN, CONFIRMED_OPT_IN or UNKNOWN"},"sms_marketing_consent.state":{"type":"string","description":"SMS marketing consent state, e.g. SUBSCRIBED, NOT_SUBSCRIBED or UNSUBSCRIBED"},"tags":{"type":"array","items":{"type":"string"},"description":"Customer tags set in Shopify"},"total_spent":{"type":"number","format":"float","description":"Customer's total amount spent in your shop"},"updated_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp of when the customer record was last updated"},"verified_email":{"type":"boolean","description":"Whether the customer has verified their email address"}}}}}}
```

### Address

Address object. Used for customer default addresses, billing addresses, shipping addresses, and fulfillment origin and destination addresses.

## The address object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"address":{"type":"object","description":"Address object. Used for customer default addresses and fulfillment origin/destination addresses.","properties":{"address1":{"type":"string","description":"Address line 1"},"address2":{"type":"string","description":"Address line 2"},"city":{"type":"string","description":"City"},"company":{"type":"string","description":"Company"},"country":{"type":"string","description":"Country"},"first_name":{"type":"string","description":"First name"},"full_name":{"type":"string","description":"Full name"},"last_name":{"type":"string","description":"Last name"},"phone":{"type":"string","description":"Phone"},"postal_code":{"type":"string","description":"Postal/ZIP code"},"province":{"type":"string","description":"Province/State"},"province_code":{"type":"string","description":"Province/State code"}}}}}}
```

### Shipping address

Shipping address for the order.

## The shipping\_address object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"shipping_address":{"type":"object","description":"Shipping address on checkout and order events.","properties":{"address1":{"type":"string","description":"Address line 1"},"address2":{"type":"string","description":"Address line 2"},"city":{"type":"string","description":"City"},"company":{"type":"string","description":"Company"},"country":{"type":"string","description":"Country"},"first_name":{"type":"string","description":"First name"},"full_name":{"type":"string","description":"Full name"},"last_name":{"type":"string","description":"Last name"},"phone":{"type":"string","description":"Phone"},"postal_code":{"type":"string","description":"Postal/ZIP code"},"province":{"type":"string","description":"Province/State"},"province_code":{"type":"string","description":"Province/State code"}}}}}}
```

### Billing address

Billing address for the order.

## The billing\_address object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"billing_address":{"type":"object","description":"Billing address on checkout and order events.","properties":{"address1":{"type":"string","description":"Address line 1"},"address2":{"type":"string","description":"Address line 2"},"city":{"type":"string","description":"City"},"company":{"type":"string","description":"Company"},"country":{"type":"string","description":"Country"},"first_name":{"type":"string","description":"First name"},"full_name":{"type":"string","description":"Full name"},"last_name":{"type":"string","description":"Last name"},"phone":{"type":"string","description":"Phone"},"postal_code":{"type":"string","description":"Postal/ZIP code"},"province":{"type":"string","description":"Province/State"},"province_code":{"type":"string","description":"Province/State code"}}}}}}
```

### Money

Monetary totals broken down by shop and presentment currency.

## The money object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"money":{"type":"object","description":"Monetary totals broken down by shop and presentment currency.","properties":{"currency.presentment":{"type":"string","description":"Currency the customer was shown at checkout (presentment currency), e.g. EUR"},"currency.shop":{"type":"string","description":"Shop's base currency code, e.g. USD"},"discounts.presentment":{"type":"number","format":"float","description":"Total discounts applied in the Presentment currency"},"discounts.shop":{"type":"number","format":"float","description":"Total discounts applied in the Shop currency"},"profit_margin_applied":{"type":"number","format":"float","description":"Weighted-average profit margin applied across line items, as a decimal (e.g. 0.40 for 40%)."},"profit_total.presentment":{"type":"number","format":"float","description":"Profit-optimised total: sum of per-item profit values in the Presentment currency"},"profit_total.shop":{"type":"number","format":"float","description":"Profit-optimised total: sum of per-item profit values in the Shop currency"},"shipping.presentment":{"type":"number","format":"float","description":"Total shipping cost in the Presentment currency"},"shipping.shop":{"type":"number","format":"float","description":"Total shipping cost in the Shop currency"},"subtotal.presentment":{"type":"number","format":"float","description":"Total price of the items before tax and shipping, but with discounts applied in the Presentment currency"},"subtotal.shop":{"type":"number","format":"float","description":"Total price of the items before tax and shipping, but with discounts applied in the Shop currency"},"tax.presentment":{"type":"number","format":"float","description":"Total tax paid in the Presentment currency"},"tax.shop":{"type":"number","format":"float","description":"Total tax paid in the Shop currency"},"total.presentment":{"type":"number","format":"float","description":"Total price (subtotal + tax + shipping) in the Presentment currency"},"total.shop":{"type":"number","format":"float","description":"Total price (subtotal + tax + shipping) in the Shop currency"},"total_items.presentment":{"type":"number","format":"float","description":"Total price of the items before tax, shipping and discounts in the Presentment currency"},"total_items.shop":{"type":"number","format":"float","description":"Total price of the items before tax, shipping and discounts in the Shop currency"}}}}}}
```

### Shop

Shop-level metadata about the Shopify store.

## The shop object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"shop":{"type":"object","description":"Shop-level metadata about the Shopify store.","properties":{"country":{"type":"string","description":"Shop's origin country code"},"currency":{"type":"string","description":"Shop's base currency code, e.g. USD"},"domain":{"type":"string","format":"uri","description":"Shop's public domain"},"shopify_domain":{"type":"string","description":"Shop's myshopify.com domain, e.g. store.myshopify.com"},"title":{"type":"string","description":"Shop name as set in Shopify admin"}}}}}}
```

### Market

Shopify Markets information for cross-border selling.

## The market object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"market":{"type":"object","description":"Shopify Markets information for cross-border selling.","properties":{"handle":{"type":"string","description":"Shopify Market handle"},"id":{"type":"string","description":"Shopify Market ID"}}}}}}
```

### Context

Event context including device, browser, page, campaign, and session metadata.

## The context object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"context":{"type":"object","description":"Event context including device, browser, page, campaign, and session metadata.","properties":{"campaign.utm_campaign":{"type":"string","description":"UTM campaign name"},"campaign.utm_content":{"type":"string","description":"UTM content"},"campaign.utm_id":{"type":"string","description":"UTM campaign ID"},"campaign.utm_medium":{"type":"string","description":"UTM medium"},"campaign.utm_source":{"type":"string","description":"UTM source"},"campaign.utm_term":{"type":"string","description":"UTM term"},"client_hints.architecture":{"type":"string","description":"Client Hints: CPU architecture"},"client_hints.bitness":{"type":"string","description":"Client Hints: CPU bitness"},"client_hints.device_type":{"type":"string","description":"Client Hints: device type"},"client_hints.mobile":{"type":"boolean","description":"Client Hints: is mobile device"},"client_hints.model":{"type":"string","description":"Client Hints: device model"},"client_hints.platform":{"type":"string","description":"Client Hints: platform (e.g. Windows, macOS)"},"client_hints.platform_version":{"type":"string","description":"Client Hints: platform version"},"client_hints.vendor":{"type":"string","description":"Client Hints: browser vendor"},"client_hints.wow_64":{"type":"boolean","description":"Client Hints: whether the browser runs under Windows 32-on-64 (WoW64) emulation"},"country":{"type":"string","description":"Client country as a two-letter ISO code, e.g. US"},"ipv4":{"type":"string","description":"Client IPv4 address"},"ipv6":{"type":"string","description":"Client IPv6 address"},"language":{"type":"string","description":"Client language ISO code"},"littledata_id":{"type":"string","description":"Littledata's persistent client ID for this visitor"},"locale":{"type":"string","description":"Client locale"},"page.path":{"type":"string","description":"Page path"},"page.referrer":{"type":"string","format":"uri","description":"Page referrer URL"},"page.search":{"type":"string","description":"Page search/query string"},"page.title":{"type":"string","description":"Page title"},"page.url":{"type":"string","format":"uri","description":"Page URL"},"screen.density":{"type":"string","description":"Screen pixel density"},"screen.height":{"type":"string","description":"Screen height"},"screen.width":{"type":"string","description":"Screen width"},"shopify_y":{"type":"string","description":"Shopify _shopify_y cookie, Shopify's anonymous visitor ID"},"timezone":{"type":"string","description":"Client timezone in IANA tzdata format, e.g. Europe/London"},"user_agent":{"type":"string","description":"Client User-Agent string"},"consent.analytics":{"type":"boolean","description":"Whether the visitor granted consent for analytics tracking"},"consent.marketing":{"type":"boolean","description":"Whether the visitor granted consent for marketing"},"consent.preferences":{"type":"boolean","description":"Whether the visitor granted consent for preferences/personalisation"},"consent.sale_of_data":{"type":"string","description":"Whether the visitor allowed the sale or sharing of their data (US state privacy laws)"}}}}}}
```

### Client IDs

Client identifiers from analytics destinations such as GA4 and Meta.

## The client\_id object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"client_id":{"type":"object","description":"Client identifiers from analytics destinations (GA4, Meta, etc.).","properties":{"attentive.attentive_id":{"type":"string","description":"Attentive _attentive_id cookie, Attentive's visitor ID"},"facebook.fbc":{"type":"string","description":"Meta _fbc cookie holding the Facebook click ID (fbclid), used for Meta CAPI event matching"},"facebook.fbp":{"type":"string","description":"Meta _fbp cookie, Meta's anonymous browser ID used for Meta CAPI event matching"},"google_ads.gbraid":{"type":"string","description":"Google Ads gbraid click ID, the privacy-safe click identifier for iOS app campaigns"},"google_ads.gclid":{"type":"string","description":"Google Ads gclid click ID, used for ad click attribution and offline conversion matching"},"google_ads.wbraid":{"type":"string","description":"Google Ads wbraid click ID, the privacy-safe click identifier for iOS web campaigns"},"google_analytics4.client_id":{"type":"string","description":"Google Analytics 4 client ID, from the _ga cookie"},"google_analytics4.session_count":{"type":"string","description":"GA4 session count for this client, from the _ga_<container> cookie"},"google_analytics4.session_id":{"type":"string","description":"GA4 session ID from the _ga_<container> cookie, used to stitch server-side events into the session"},"klaviyo.exchange_id":{"type":"string","description":"Klaviyo _kx cookie (exchange ID) identifying the Klaviyo profile"},"microsoft.msclkid":{"type":"string","description":"Microsoft Advertising msclkid click ID, used for UET conversion matching"},"pinterest.epik":{"type":"string","description":"Pinterest _epik cookie holding the Pinterest click ID, used for Pinterest API matching"},"segment.anonymous_id":{"type":"string","description":"Segment anonymousId, from the ajs_anonymous_id cookie"},"tiktok.ttclid":{"type":"string","description":"TikTok ttclid click ID, used for TikTok Events API matching"},"tiktok.ttp":{"type":"string","description":"TikTok _ttp cookie, TikTok's browser ID used for TikTok Events API matching"}}}}}}
```

### Discount codes

Discount code applied to the order.

## The discount\_codes object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"discount_codes":{"type":"object","description":"Discount code applied to the order.","properties":{"amount":{"type":"number","format":"float","description":"Discount amount"},"code":{"type":"string","description":"Discount code"},"type":{"type":"string","description":"Discount type: percentage, fixed_amount or shipping"}}}}}}
```

### Note attributes

Custom note attribute (key/value pair) attached to the order.

## The note\_attributes object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"note_attributes":{"type":"object","description":"Custom note attribute (key/value pair) attached to the order.","properties":{"__ld_attr":{"type":"string","description":"Internal Littledata note attribute holding the visitor's session and attribution data as JSON"},"name":{"type":"string","description":"Name of the order note attribute (Shopify cart attribute)"},"value":{"type":"number","format":"float","description":"Value of the order note attribute"}}}}}}
```

### Shipping lines

Shipping line item on the order.

## The shipping\_lines object

```json
{"openapi":"3.1.0","info":{"title":"Event Editor Reference","version":"1.0.0"},"components":{"schemas":{"shipping_lines":{"type":"object","description":"Shipping line item on the order.","properties":{"code":{"type":"string","description":"Shipping rate code, e.g. STANDARD"},"price":{"type":"number","format":"float","description":"Shipping line price"},"title":{"type":"string","description":"Shipping rate name shown to the customer, e.g. Standard Shipping"}}}}}}
```