• WordPress
  • Setup

Monolytics for WordPress

Connect your WordPress site to Monolytics directly from wp-admin — without copying tracking code, editing theme files, or running a Tag Manager. One click in the plugin, one Monolytics login, and behavior analytics start flowing for the connected domain.

Get the plugin on WordPress.org

What the plugin does

  • Connects the current WordPress site to Monolytics from the WordPress admin area.
  • Shows the live connection status, the timestamp of the connect, and the connected domain.
  • Reports whether DataLayer event tracking is enabled for the connected domain.
  • Shows the number of sessions tracked for the connected domain in the current billing cycle.
  • Opens the Monolytics dashboard in the correct site context with one click.
  • Lets you disconnect the site locally without deleting the connected Monolytics domain or historical analytics data.
  • Stays out of wp-admin by default — the tracker is not injected into the WordPress admin area.

Quick setup

  1. Install the plugin. From the WordPress plugin directory at wordpress.org/plugins/monolytics, or upload the plugin zip manually.
  2. Activate Monolytics from the Plugins page in wp-admin.
  3. Open Monolytics in the WordPress admin sidebar.
  4. Click Connect Monolytics. The plugin will hand off to the Monolytics auth flow.
  5. Complete the Monolytics login, signup, or Google auth flow. Existing users sign in, new users register and pick a workspace.
  6. Return to WordPress and confirm the connected status. You should land on the plugin page with status Connected.

What you should see after a successful connection

  • Connection status — Connected, with the timestamp of the connect.
  • DataLayer event tracking — whether the canonical domain has DataLayer interception enabled, with a toggle to change it.
  • Sessions tracked — the count for the connected domain in the current billing cycle.
  • Open Monolytics dashboard — one-click handoff to cloud.monolytics.app in the correct site context.
  • Disconnect — local disconnect that keeps the remote Monolytics domain and historical data intact.

Troubleshooting

The site does not connect

  • Start the connect flow from the plugin page inside wp-admin, not from a copied link.
  • Finish the Monolytics login or signup flow in the same browser, then return to the same WordPress site.
  • Make sure the current site URL is the domain you expect to connect to Monolytics. If the site resolves to localhost, a private IP, or a test-only host, the plugin will block the connect — Monolytics requires a publicly reachable origin.

DataLayer event tracking is not enabled

The plugin reflects the canonical DataLayer setting for the connected Monolytics domain. If the toggle is off, re-check the domain settings in the Monolytics dashboard and confirm the WordPress site is connected to the workspace and domain you intended.

No sessions are showing yet

After the site is connected, the plugin loads the Monolytics tracker on the public front end if local tracking stays enabled. If session count remains zero, visit the public site once, confirm the expected domain is the one linked to Monolytics, and wait a few minutes for the first sessions to land.

Disconnecting or uninstalling the plugin

Disconnecting or uninstalling the plugin removes the local WordPress-side connection state and stops local tracker injection. It does not delete the connected Monolytics domain or historical analytics data in Monolytics Cloud — re-installing and reconnecting picks up where you left off.

Privacy and external services

The plugin does not contact Monolytics until a WordPress administrator explicitly starts the connect flow from the WordPress admin area.

When a site is connected, the plugin communicates with the following Monolytics-hosted services so the correct connected site can be created or reused and kept in sync:

  • monolytics.app — public Monolytics service website
  • api.monolytics.app — plugin onboarding, connection state, and canonical domain settings
  • cloud.monolytics.app — hosted Monolytics authentication and dashboard
  • cloud.monolytics.app/tracker.js — front-end session tracker, only when the site is connected and local tracking stays enabled

The data sent to Monolytics on connect: the current WordPress site URL, the WordPress site name, generated installation and domain identifiers, and plugin setting updates such as the DataLayer interception state. These requests are required so Monolytics can create or reuse the correct connected site and keep WordPress plugin settings aligned with the canonical Monolytics domain configuration.

For full details see the Monolytics Privacy Policy and Terms of Use.

Plugin requirements

  • WordPress 6.8 or newer (tested up to WordPress 6.9)
  • PHP 7.4 or newer
  • A publicly reachable WordPress site URL
  • A Monolytics account (free or paid)

Get the plugin

Install Monolytics from WordPress.org

Already have a Monolytics workspace? You can sign in first, then connect your WordPress site from the plugin in wp-admin.