---
title: "WordPress"
description: "Install the Sealmetrics WordPress plugin for cookieless analytics with search, 404, and Contact Form 7 lead tracking — no consent banner required."
canonical_url: "https://docs.sealmetrics.com/integrations/cms/wordpress"
lang: "en"
date_generated: "2026-09-14T16:17:59.677Z"
source_hash: "fd170c8acf6ec4d57c1dafaef8ee5158a3915091334bfc3f582373f84bd219b6"
content_type: "implementation"
owner: "engineering"
llm_priority: "critical"
source_file: "integrations/cms/wordpress.mdx"
publisher: "Sealmetrics"
---

# WordPress

Canonical page: https://docs.sealmetrics.com/integrations/cms/wordpress

Privacy-first, cookieless analytics for WordPress sites (without WooCommerce).

**Info:**
If you're using WooCommerce, use the [WooCommerce plugin](/integrations/ecommerce/woocommerce) instead for complete e-commerce tracking.

## Requirements

- WordPress 5.8+
- PHP 7.4+

## Installation

### Step 1: Get the Plugin

Download the Sealmetrics WordPress 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) |
| **Search Tracking** | Track search queries as microconversions (default on) |
| **404 Tracking** | Track 404 errors as microconversions (default on) |
| **Author Tracking** | Include author name in post properties (default off) |
| **Contact Forms as Lead** | Track contact form submissions as conversions (default on) |
| **Contact Form 7** | Track Contact Form 7 submissions (default on) |
| **Gravity Forms** | Track Gravity Forms submissions (default on) |
| **WPForms** | Track WPForms submissions (default on) |
| **Elementor Forms** | Track Elementor form submissions (default on) |

## Tracked Events

### Automatic Events

These events are tracked automatically without any additional configuration:

| Event | Type | Description |
|-------|------|-------------|
| `pageview` | Auto | All pages with automatic content grouping |
| `search` | Microconversion | Search queries with results count |
| `404_error` | Microconversion | Broken link visits |

### Form Events

| Event | Type | Description |
|-------|------|-------------|
| `form_submit` | Microconversion | Contact form submissions |
| `newsletter_signup` | Microconversion | Newsletter form submissions |
| `lead` | Conversion | Contact forms (if "Track as Leads" is enabled) |

## Content Groups

Content groups are automatically detected based on WordPress page type:

| Page Type | Group |
|-----------|-------|
| Home page | `home` |
| Blog posts | `post` |
| Static pages | `page` |
| Categories | `category` |
| Tags | `tag` |
| Author archives | `author` |
| Search results | `search` |
| 404 pages | `404` |
| Custom post types | `{post_type}` |

## Form Plugin Support

The plugin automatically tracks forms from these popular plugins:

- Contact Form 7
- Gravity Forms
- WPForms
- Elementor Forms
- Generic HTML forms

### Newsletter Detection

Forms are automatically classified as newsletter subscriptions if:
- Form ID/class contains: `newsletter`, `subscribe`, `mailchimp`, `convertkit`, `mailerlite`
- Form action URL contains newsletter keywords
- Form has only an email field

### Contact vs Newsletter Example

```javascript
// Newsletter form - automatically detected
sealmetrics.micro('newsletter_signup', {
  form_name: 'sidebar_newsletter',
  form_type: 'cf7'
});

// Contact form with "Track as Leads" enabled
sealmetrics.conv('lead', 0, {
  source: 'contact_form',
  form_name: 'contact_page_form',
  form_type: 'gravity'
});

// Contact form (default behavior)
sealmetrics.micro('form_submit', {
  form_name: 'contact_page_form',
  form_type: 'gravity'
});
```

## Custom Post Types

Custom post types are automatically tracked with their own content group. For example:

| Post Type | Group |
|-----------|-------|
| `portfolio` | `portfolio` |
| `product` | `product` |
| `service` | `service` |
| `testimonial` | `testimonial` |

## Privacy

- No cookies used
- No personal 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 (if using a caching plugin)
3. Clear browser cache
4. Check browser console for JavaScript errors
5. Temporarily disable other plugins to check for conflicts

### Forms not tracking

1. Verify your form plugin is in the [supported list](#form-plugin-support)
2. Check the form has proper HTML structure
3. Test form submission manually and check the network tab

### Wrong content group

1. Check the page type in WordPress admin
2. Verify no custom templates are overriding the page type

## Related documentation

- [Installation](/implementation/tracker/installation) — how the underlying Sealmetrics tracker loads and how to set a custom pixel domain.
- [Understanding Event Properties in Sealmetrics](/implementation/custom-properties/event-properties) — the model behind the form, search, and 404 microconversions this plugin fires.
- [Joomla](/integrations/cms/joomla) — the equivalent integration for Joomla sites.
- [Drupal](/integrations/cms/drupal) — the equivalent integration for Drupal sites.
- [Integrations Overview](/integrations) — browse every platform Sealmetrics supports.