Products Table

The Products table provides the product catalog with attributes like name, type, vendor, status, and variants. One row per product. Sourced from the connected sales platform.

📋

Table Guide

What You Can Answer With This Table

  • Which products or variants are out of stock or inactive? — filter where product_inventory_quantity = 0 or variants.variant_inventory_quantity = 0, group by product_status
  • What products does a specific vendor supply? — filter or group by vendor

Before You Query

  • This table is not time-series. No event_date filter is needed.

Key Relationships

TableJoin KeyUse This Join To
Product Analyticsproduct_idMeasure catalog product performance over time with revenue, orders, and units sold

When to Use a Different Table

  • Use Product Analytics table when you need product sales performance over time, such as revenue, units sold, or orders by product. The Products table is for catalog attributes.
  • Use Orders table when you need product data in the context of individual orders. The Products table is for the product catalog, not order-line detail.

View the full Triple Whale Data Ontology →


Dimensions

Dimensions are immutable properties that can be used for grouping data.

TitleIDTypeDescription
Collectionscollectionsrepeated stringCollections the product belongs to, as set within the main sales platform.Example values: Summer Gift Guide, Long-Sleeve Packs, Christmas Collection
Product Imagesimagesrecord repeatedImages associated with the product, with details such as image position, dimensions, and source URL.
Image Positionimages.image_positionstringThe position of the image in the product gallery.Example values: 1, 5, 19, 43
Image Widthimages.image_widthstringThe width of the image in pixels.Example values: 500, 1080, 1500, 2048
Image Heightimages.image_heightstringThe height of the image in pixels.Example values: 500, 1080, 1500, 2048
Image Sourceimages.image_srcstringThe URL of the product image.Example values: https://cdn.shopify.com/.../product1.jpg, https://m.media-amazon.com/.../image1.jpg
Integration IDintegration_idstringThe unique identifier for the integration (store connection) that this product belongs to.
PlatformplatformstringThe platform or marketplace where the product is listed.Example values: shopify, amazon, custom
Product Descriptionproduct_descriptionstringThe description of the product as written by the seller.Example values: Classic everyday denim designed for comfort and versatility, featuring premium stretch fabric, durable stitching, and a timeless silhouette suitable for any wardrobe.
Product IDproduct_idstringThe unique ID of the product as set within the main sales platform.Example value: 3891505496131
Primary Product Imageproduct_image_urlstringThe URL of the primary product image.Example values: https://cdn.shopify.com/.../product1.jpg, https://m.media-amazon.com/.../image1.jpg
Product Nameproduct_namestringThe name (or title) of the product as set within the main sales platform.Example values: Green Soft Socks 3-Pack, Paring Knife Travel Case, Gift Subscription
Product Statusproduct_statusstringThe status of the product.Example values: active, draft, archived
Product Tagsproduct_tagsrepeated stringTags associated with the product, assigned by the seller in the main sales platform.Example values: 3-pack, Sale, discount_eligible
Product Typeproduct_typestringThe product type as set within the main sales platform.Example values: Jackets, Coffee Mugs, Books
Shop IDshop_idstringThe unique ID of the shop (often corresponds to the shop domain). Can be used to group or filter data by shop in multi-store reports.Example values: example-US.myshopify.com, example-EU.myshopify.com
Shop Nameshop_namestringThe name of the shop. Can be used to group or filter data by shop in multi-store reports.Example values: example-US, example-EU
Product Variantsvariantsrecord repeatedDetails about the product variants associated with the order.
Variant IDvariants.variant_idstringThe unique ID of the product variant as set within the main sales platform.Example value: 47095335813393
Variant Namevariants.variant_namestringThe name (or title) of the product variant as set within the main sales platform.Example values: 36 S, Titanium / Mild, Black Leather
Variant Descriptionvariants.variant_descriptionstringThe description of the product variant. Only supported for Amazon products.Example values: High-rise skinny fit in stretch denim, designed to sit at the natural waist for a flattering, sculpted silhouette.
Variant SKUvariants.skustringThe SKU (Stock Keeping Unit) for the product variant as set within the main sales platform.Example values: GP-BACK-02, A02630, POP200NAVY
Variant Pricevariants.variant_pricenumericThe price of a single product variant (to the buyer).Example values: 69.99, 10, 1200
Variant Inventory Quantityvariants.variant_inventory_quantitynumericThe number of items in stock for the product variant.Example values: 100, 50, 0
VendorvendorstringThe vendor of the product variant.Example values: Route, Canon, Corso, MyShop

Measures

Measures are numeric fields that can be aggregated and/or combined to calculate new metrics.

TitleIDTypeDescription
Product Inventory Quantityproduct_inventory_quantitynumeric

The number of items in stock for the product.

Example values: 100, 50, 0