Beam for WordPress

Install Beam on WordPress

Replace YOUR_SITE_ID with your Beam site ID from the dashboard.

Option A - Install the official Beam plugin package

# In this repo, build an installable plugin zip:
cd beam-wordpress-plugin
./build-plugin-zip.sh

# In WordPress admin:
Plugins -> Add New -> Upload Plugin
# Upload beam-analytics.zip, activate it,
# then open Settings -> Beam Analytics
# and paste your Beam Site ID

The official plugin is source-controlled in this repo at beam-wordpress-plugin/beam-analytics, uses WordPress settings APIs, and includes an option to skip logged-in administrators. See the public plugin surface at /wordpress-plugin for packaging assets and launch copy.

Option B - Add to functions.php (no plugin install)

// Add to your theme's functions.php
function beam_analytics_script() {
    echo '<script defer src="https://beam.keylightdigital.dev/js/beam.js" data-site-id="YOUR_SITE_ID"></script>';
}
add_action( 'wp_head', 'beam_analytics_script' );

The wp_head hook injects Beam into every page, post, category archive, and custom template.

Option C - Use a header/footer snippet plugin

<!-- Paste into your plugin's "Header" field -->
<script
  defer
  src="https://beam.keylightdigital.dev/js/beam.js"
  data-site-id="YOUR_SITE_ID">
</script>

Use this for no-code installs inside WordPress admin when you prefer not to touch PHP files.

Official WordPress plugin launch surface

Need submission-ready packaging docs and a quick explanation for non-technical owners? Use the dedicated plugin page.

Open plugin page Create Beam account

Verify your WordPress integration

Use this checklist after publish so you know tracking is actually live in production.

✓ Publish the snippet, then open your homepage and one post URL in a private browser window.
✓ In Beam dashboard, confirm both URLs show up in Top Pages within a minute.
✓ If data is missing, verify caching/CDN plugins are not stripping custom head snippets.

Why Beam works well for WordPress

🍪

No cookie banner requirement

Beam collects no personal data and sets no cookies, so WordPress sites can avoid analytics consent prompts.

🚀

No plugin bloat

One lightweight script replaces heavy analytics plugins and keeps wp-admin cleaner.

🔒

GDPR and CCPA by default

No IP storage, no fingerprinting, and no cross-site identifiers means low compliance overhead.

📈

Focus on useful metrics

See what content drives traffic without navigating complex GA-style dashboards.

Ready to add Beam to WordPress?

Start free, validate your first pageview, and then scale when traffic grows.

Start tracking for free See live demo first