DataLayer Builder + Validator

Build correct dataLayer.push() code for any GA4 event, or paste existing code to validate it.

Build mode: Select an event type, fill in the fields, and get ready-to-use code with live validation.

Validate mode: Paste existing dataLayer.push() code and get instant feedback on errors, warnings, and suggestions.

BuildValidate

Start from Example

Purchase (full) — Complete ecommerce transaction with itemsAdd to Cart — Single item with price and quantityLead Generation — Simple form submission

Event Type

Select Event *view_item_listselect_itemview_itemadd_to_cartremove_from_cartview_cartbegin_checkoutadd_shipping_infoadd_payment_infopurchaserefundview_promotionselect_promotionloginsign_upsearchgenerate_leadshareselect_contentCustom Event

User completes a purchase transaction

Options

Include ecommerce clearingAdds dataLayer.push({ ecommerce: null }) before the event push to prevent data merging.

Include user_data for Enhanced ConversionsAdds a user_data comment/snippet for Google Ads Enhanced Conversions.

Event Parameters

Transaction ID *Your order ID from your backend/CMS (e.g., Shopify order number). Must be unique per transaction — GA4 uses this to deduplicate revenue.

Currency *3-letter currency code matching your store (e.g., USD, EUR, SEK). Must match the currency of the value field.

Value *Total order revenue including tax and shipping. Must be a number — this is what GA4 reports as revenue.

TaxTax amount for this order. Must be a number.

ShippingShipping cost for this order. Must be a number.

CouponOrder-level coupon code applied to this purchase.

AffiliationStore or partner that fulfilled this order (e.g., 'Google Store', 'Partner Marketplace').

Items+ Add Item

Item 1

Item ID *Your product SKU or ID from your catalog. Use the same ID across all events (view_item → add_to_cart → purchase) for funnel analysis.

Item Name *Product name as shown to the user. GA4 uses this for reporting if item_id isn't set.

Price *Unit price of this item. Must be a number — '29.99' (string) won't work, use 29.99 (number).

Quantity *Number of this item. Defaults to 1 if omitted, but always include it explicitly.

BrandBrand or manufacturer. Useful for brand performance reports in GA4.

CategoryPrimary product category (e.g., 'Apparel'). Use category2-5 for sub-categories — don't put the full path here.

Category 2Second-level category (e.g., 'T-Shirts'). Build your hierarchy: Apparel > T-Shirts > Short Sleeve.

Category 3Third-level category. Don't skip levels — if you use category3, set category2 too.

Category 4Fourth-level category. Most implementations only need 2-3 levels.

Category 5Fifth-level category. GA4 supports up to 5 levels.

VariantProduct variant like color or size. Use a consistent format (e.g., 'Blue / Large').

List IDID of the list this item appeared in (e.g., 'search_results', 'related_products').

List NameDisplay name of the list (e.g., 'Related Products', 'Search Results').

IndexPosition of the item in the list (0-based). Useful for tracking which position gets the most clicks.

CouponItem-level coupon code, if different from the order-level coupon.

DiscountDiscount amount applied to this item (as a positive number, e.g., 5.00).

AffiliationStore or partner that fulfilled this item (e.g., 'Google Store', 'Amazon Marketplace').

Field Status

⚠️ Missing required fields: Transaction ID, Currency, Value

⚠️ Add at least one item with an item_id or item_name.

Generated dataLayer.push()Copy

// Clear previous ecommerce data
dataLayer.push({ ecommerce: null });

dataLayer.push({
  event: 'purchase',
  ecommerce: {
    items: [
      {
        quantity: 1
      }
    ]
  }
});