Waverunner
Browse the docs

Install on WordPress

Part of Waverunner’s always-on, site-measured performance stack. The safest way to add a snippet to WordPress is a header plugin: your change survives theme updates and you never touch code files. We recommend the free WPCode plugin, used by millions of sites.

First, copy your snippet

Your snippet is one line of code that looks like this, with YOUR_SITE_TOKEN replaced by a code that is unique to your website:

<script async src="https://waverunner.adwave.com/t/YOUR_SITE_TOKEN"></script>

Get the real one from your Waverunner account: sign in to copy your site's snippet. You'll land on the Tracking page, which shows your personalized snippet with a Copy snippet button. Each website (business) in your account has its own snippet. If you run more than one site, pick the right one with the switcher at the top of the page. Copy it there, then follow the steps below.

Don't copy the example above: it contains a placeholder instead of your real site token, so nothing would be recorded.

Install the WPCode plugin

Skip this section if you already have WPCode (or a similar header plugin) installed.

  1. Log in to your WordPress admin (usually yoursite.com/wp-admin).
  2. In the left menu, go to Plugins → Add New Plugin.
  3. Search for WPCode(full name: "WPCode – Insert Headers and Footers").
  4. Click Install Now, then Activate.

Paste the snippet

  1. In the left menu, go to Code Snippets → Header & Footer (the Code Snippets menu appears once WPCode is active).
  2. Paste your snippet into the Header box (the first one).
  3. Click Save Changes.

That's it. WPCode loads the snippet on every page of your site automatically, including pages you create later.

Keep the plugin active: if WPCode is deactivated, the snippet stops loading (your saved code is kept, so reactivating restores it). Some themes also offer a built-in "Header scripts" field under Appearance → Customize: that works too, but the setting is lost if you ever switch themes, which is why we recommend the plugin.

Check that it's working

  1. Open your website in a new browser tab and load any page.
  2. Go back to the Tracking page in Waverunner (you'll be asked to sign in if you aren't already). The banner at the top turns green on its own the moment your first visit arrives, usually within a few seconds. No need to reload the page.

If the banner stays amber after a minute, re-check the steps above: the most common causes are pasting the example snippet instead of your personalized one, or forgetting to save or publish the change.