---
title: "WooCommerce"
description: "Install the Sealmetrics WooCommerce plugin for cookieless tracking of the full e-commerce funnel — product views, cart, checkout, and purchase revenue."
canonical_url: "https://docs.sealmetrics.com/integrations/ecommerce/woocommerce"
lang: "en"
date_generated: "2026-09-14T16:17:59.677Z"
source_hash: "8c2a108f6705604c7ee6ac74e8bcb3e41b5dc362a48aae1e8de8c865f2530857"
content_type: "implementation"
owner: "engineering"
llm_priority: "critical"
source_file: "integrations/ecommerce/woocommerce.mdx"
publisher: "Sealmetrics"
---

# WooCommerce

Canonical page: https://docs.sealmetrics.com/integrations/ecommerce/woocommerce

Privacy-first, cookieless analytics for WordPress + WooCommerce stores with complete e-commerce funnel tracking.

## Requirements

- WordPress 5.8+
- WooCommerce 6.0+
- PHP 7.4+

## Installation

### Step 1: Get the Plugin

Download the Sealmetrics WooCommerce plugin from your Sealmetrics dashboard, under **Settings → Integrations**.

### Step 2: Upload to WordPress

1. Go to **WordPress Admin > Plugins > Add New > Upload Plugin**
2. Upload the ZIP file and click **Install Now**
3. Activate the plugin

### Step 3: Configure

1. Go to **Settings > Sealmetrics**
2. Enter your **Account ID** — this is your Site ID, shown in **Settings → Sites → [your site] → General** ([how to find it](/platform/account-setup/find-account-id))
3. Save changes

## Configuration Options

| Setting | Description |
|---------|-------------|
| **Account ID** | Your Sealmetrics Account ID (required) |
| **Pixel URL** | Custom pixel domain for first-party tracking (optional) |

## E-commerce Events

The plugin automatically tracks the complete e-commerce funnel:

| Event | Type | Properties |
|-------|------|------------|
| `pageview` | Auto | All pages with content grouping |
| `view_item` | Microconversion | product_name, product_id, sku, price, currency, category, brand |
| `add_to_cart` | Microconversion | product_name, product_id, sku, price, quantity, currency, variation attributes |
| `begin_checkout` | Microconversion | cart_total, currency, items_count |
| `purchase` | Conversion | revenue, currency, payment_method, coupon, items array |

## Content Groups

Automatic detection based on WooCommerce page type:

| Page Type | Group |
|-----------|-------|
| Shop page | `catalog` |
| Product category | `catalog` |
| Single product | `product` |
| Cart | `cart` |
| Checkout | `checkout` |
| Order confirmation | `thankyou` |
| My Account | `account` |

## Features

### Brand Detection

The plugin automatically detects product brands from popular plugins:
- YITH WooCommerce Brands
- Perfect Brands for WooCommerce
- WooCommerce Brands
- Custom `product_brand` taxonomy

### Variable Products

All variation attributes are captured automatically:

```javascript
{
  product_name: "T-Shirt - Large, Blue",
  size: "Large",
  color: "Blue",
  // ... other selected attributes
}
```

### Add to Cart Tracking

Works with all add-to-cart methods:
- Standard add to cart buttons
- AJAX add to cart
- Variable product forms
- Quantity changes

### Purchase Tracking

Full e-commerce data is captured on order confirmation:

```javascript
sealmetrics.conv('purchase', 129.99, {
  currency: 'EUR',
  payment_method: 'PayPal',
  coupon: 'SAVE10',
  items: [
    {
      product_id: '123',
      product_name: 'Product Name',
      sku: 'SKU-123',
      price: '49.99',
      quantity: '2',
      category: 'Clothing',
      brand: 'Brand Name',
      size: 'Large',
      color: 'Blue'
    }
  ]
});
```

### Duplicate Prevention

The plugin prevents duplicate purchase tracking:
- Uses order meta to track sent conversions
- Handles page refreshes on thank you page

## Privacy

- No cookies used
- No order IDs stored externally
- No customer data collected
- Designed for GDPR and ePrivacy (self-assessed, see [Compliance](/compliance))
- No consent banner needed

## Troubleshooting

### Tracker not loading

1. Verify Account ID is configured in **Settings > Sealmetrics**
2. Clear WordPress cache
3. Check browser console for JavaScript errors

### Purchases not tracking

1. Ensure the order confirmation page loads correctly
2. Check WooCommerce order status is "completed" or "processing"
3. Verify no conflicting analytics plugins

### Add to cart not working

1. Check AJAX add to cart is enabled in WooCommerce settings
2. Verify no JavaScript errors in browser console
3. Test with the default theme (Storefront) to rule out theme conflicts

## Related documentation

- [Installation](/implementation/tracker/installation) — how the underlying tracker loads, useful if you set a custom pixel domain.
- [E-commerce Conversion Tracking](/implementation/ecommerce-conversion-tracking) — the concepts behind the funnel events this plugin fires automatically.
- [Shopify](/integrations/ecommerce/shopify) — the equivalent integration for Shopify stores.
- [Magento 2](/integrations/ecommerce/magento) — the equivalent module for Magento / Adobe Commerce.
- [Integrations Overview](/integrations) — browse every platform Sealmetrics supports.