Welcome to the documentation for UTM Manager, the campaign tracking and lead attribution plugin for WordPress by BeautifulPlugins. Everything here applies to the free plugin from WordPress.org; features that belong to the UTM Manager Pro add-on are marked as Pro.
New here? Start with Installation and then follow the Quick Start guide — it takes you from a fresh install to tracked campaigns in about five minutes.
Getting Started
- Introduction — what the plugin does, what makes it different, and the screens you’ll use.
- Installation — install and activate the free plugin, verify tracking, and uninstall cleanly.
- Quick Start — from zero to tracked campaigns in five minutes.
Everyday Use
- Overview Dashboard — lead and visit totals, the new-leads trend chart, and your top sources, mediums, and campaigns.
- Managing Leads — the leads table: filters, search, sorting, and bulk actions.
- Lead Details & Visit Journey — first- and last-touch attribution plus the full page-by-page timeline per lead.
- Settings — the UTM parameter toggles and what stays deliberately zero-config.
- CSV Export — batched exports, field selection, and spreadsheet safety.
Concepts
- How Tracking Works — beacon capture, visitor IDs, first vs. last touch, and why it survives full-page caching.
- Tracking Parameters Guide — the six standard UTM keys, naming conventions, URL recipes, and custom parameters.
- Privacy & GDPR — hashed IPs, the first-party cookie, consent gating, and data deletion.
Upgrading
- Migrating from Version 1.x — the automatic background migration, what carries over, and how to verify it.
Pro
- Pro Features — everything the Pro add-on adds, and where each part appears in the admin.
- License Activation (Pro) — activate your license key and enable automatic updates.
- Custom Parameters (Pro) — capture
gclid,fbclid,ref, and any other query parameter you use. - Reports & Attribution (Pro) — date ranges, trends, and breakdowns by country, device, and custom parameter.
- Integrations (Pro) — Contact Form 7, WPForms, WooCommerce, webhooks, and the read-only REST API.
For Developers & Help
- Developer Hooks Reference — filters, actions, helper functions, and the REST beacon endpoint.
- Troubleshooting — no leads recorded, blocked beacons, missing attribution, and migration issues.
- FAQ — common questions about tracking, attribution, privacy, and Pro.
Can’t find what you need?
Search this documentation first — most answers are a page away. If you’re still stuck, open a support ticket and include your WordPress version, the plugin version, and what you expected to happen. We read every ticket.
These docs cover UTM Manager 2.0.7 and UTM Manager Pro 1.0.2.