Mapping Shopify Fields to Triple Whale
When you connect Shopify to Triple Whale, Shopify integration data is populated in the Orders Table, Products Table, Refunds Table, and Customers Table. These base tables also feed related reporting and derived tables across the Triple Whale schema. This guide lists the Triple Whale column IDs that are populated from Shopify integration data in each base table.
Orders Table
Use orders_table for order-level Shopify data. One row represents one order.
| Data area | Shopify-backed Triple Whale column IDs |
|---|---|
| Order and shop metadata | platformshop_idshop_nameshop_timezoneevent_dateevent_hourcreated_atcancelled_atorder_idorder_namesource_namefulfillment_status |
| Customer fields on the order | customer_idcustomer_id_keycustomer_first_namecustomer_last_namecustomer_emailcustomer_from_country_codecustomer_from_country_namecustomer_from_state_codecustomer_from_citycustomer_tagsis_new_customeris_subscription_orderis_first_order_in_subscription |
| Shipping address and checkout shipping amount | shipping_country_codeshipping_country_nameshipping_state_codeshipping_stateshipping_cityshipping_zipshipping_price |
| Revenue, discounts, taxes, refunds, and order counts | currencyorder_revenuegross_product_salesproduct_quantity_sold_in_orderdiscount_codediscount_typediscount_amountdiscount_amount_for_productdiscount_amount_for_shippingtaxesrefund_moneyordersorders_with_amountnew_customer_ordersreturning_customer_ordersnew_customer_revenuereturning_customer_revenuenew_customers_percentreturning_customers_percentaovtrue_aovltvunique_customers |
| Product line items in the order | products_infoproducts_info.product_idproducts_info.product_nameproducts_info.vendorproducts_info.product_typeproducts_info.product_tagsproducts_info.product_skuproducts_info.variant_idproducts_info.product_name_priceproducts_info.discount_amount_for_productproducts_info.net_discount_amount_for_productproducts_info.product_name_quantity_soldproducts_info.is_gift_cardproducts_info.single_product_costproducts_info.propertiesproducts_info.properties.nameproducts_info.properties.value |
| Shopify transaction details | payment_gateway_coststransactionstransactions.created_attransactions.processed_attransactions.payment_gateway_nametransactions.currencytransactions.statustransactions.amounttransactions.fees |
| Shopify order tags and metafields | tagsmetafieldsmetafields.metafield_idmetafields.keymetafields.valuemetafields.namespacemetafields.typemetafields.updated_atmetafields.created_at |
| Shopify product cost | cost_of_goods |
Products Table
Use products_table for Shopify product catalog data. One row represents one product.
| Data area | Shopify-backed Triple Whale column IDs |
|---|---|
| Product identity and status | shop_idshop_nameintegration_idplatformproduct_idproduct_nameproduct_descriptionvendorproduct_statusproduct_tagsproduct_typeproduct_inventory_quantity |
| Product images | product_image_urlimagesimages.image_positionimages.image_widthimages.image_heightimages.image_src |
| Product variants | variantsvariants.variant_idvariants.variant_namevariants.skuvariants.variant_pricevariants.variant_compare_at_pricevariants.variant_inventory_quantity |
| Collections | collections |
Refunds Table
Use refunds_table for individual Shopify refund transactions. One row represents one refund transaction.
| Data area | Shopify-backed Triple Whale column IDs |
|---|---|
| Refund and order metadata | shop_idshop_nameplatformevent_dateevent_hourorder_dateorder_idsource_nametags |
| Refund amounts | total_refunded_pricetotal_refunded_taxtotal_refunded_shippingtotal_refunded_cogs |
| Refunded products | products_infoproducts_info.product_idproducts_info.product_nameproducts_info.product_skuproducts_info.variant_idproducts_info.product_name_priceproducts_info.discount_amount_for_productproducts_info.product_name_quantity_soldproducts_info.is_gift_cardproducts_info.single_product_cost |
| Refund order adjustments | refund_order_adjustmentrefund_order_adjustment.kindrefund_order_adjustment.order_adjustment_tax_amountrefund_order_adjustment.order_adjustment_amount |
Customers Table
Use customers_table for Shopify customer profile data. One row represents one customer on one platform.
| Data area | Shopify-backed Triple Whale column IDs |
|---|---|
| Customer identity and contact fields | platformcustomer_idcustomer_id_keycreated_atemail_addressphonefirst_namelast_namedisplay_namecustomer_tagsnote |
| Customer address and geography | address1address2citycountrycountry_codestatestate_codeziplatitudelongitudecoordinates_validatedlocale |
| Customer status and consent | statusproduct_subscriber_statusvalid_email_addressverified_email_addressemail_marketing_consent_statusemail_marketing_consent_opt_in_levelemail_marketing_consent_updated_attax_exempt |
| Customer purchase and value fields | last_order_idamount_spentordersstatistic_predicted_spend_tier |