Official distribution surface

Beam WordPress Plugin

Use the official plugin package to inject Beam's privacy-first tracking script on WordPress sites. Keep install and account setup separate so owners know exactly what each step does.

Create Beam account Open install guide View product demo

Hosted Beam account vs WordPress plugin installer

The plugin and hosted dashboard are intentionally separate products that work together.

Hosted Beam account

Where reporting and site management happen

  • Create your account and add a site in Beam dashboard.
  • Copy your Beam Site ID from the site detail page.
  • Use dashboard analytics, channels, goals, and alerts.

WordPress plugin installer

Only handles script injection on WordPress

  • Install and activate the plugin in wp-admin.
  • Paste the Beam Site ID into Settings -> Beam Analytics.
  • Optionally skip tracking for logged-in administrators.

Build and package the plugin

Use the repeatable packaging script in this repository to generate the install zip.

cd beam-wordpress-plugin
./build-plugin-zip.sh
# Output: beam-analytics.zip
  1. Create or sign in to your Beam account and create a site.
  2. Run ./build-plugin-zip.sh to generate beam-analytics.zip.
  3. In wp-admin, go to Plugins -> Add New -> Upload Plugin, upload the zip, and activate.
  4. Open Settings -> Beam Analytics, paste your Site ID, save, then verify events in Beam.

Submission-ready assets in-repo

WordPress.org readme

beam-wordpress-plugin/beam-analytics/readme.txt includes tags, requirements, FAQ, changelog, and install instructions.

Packaging checklist

beam-wordpress-plugin/PACKAGING_CHECKLIST.md is a pre-submit QA checklist for version, docs, zip output, and manual activation test.

Repeatable zip build

beam-wordpress-plugin/build-plugin-zip.sh produces an install-ready zip from the plugin source tree.

Launch CTA paths

Evaluate the hosted product first, then install the plugin where WordPress operators manage their site.

Start free hosted account Plugin install instructions