Documentation FAQ

Longer answers than the homepage FAQ, organised by topic.

Licensing and billing

What does each tier include?

• Solo ($69): 1 production website. Lifetime updates. Email support.
• Studio ($149): 5 production websites. Lifetime updates. Priority email support.
• Agency ($349): unlimited production websites. Lifetime updates. Priority support and roadmap input.

Dev and staging activations are unlimited on every tier. Local builds, staging subdomains and pre-launch URLs do not count against your seat.

What's the refund policy?

14 days, no questions asked. If Beaconry doesn't work for your site, email us at info@beaconry.app and we refund.

How do plugin updates work?

Beaconry has a built-in self-hosted updater. The plugin polls a manifest at www.beaconry.app/downloads/beaconry.json for updates. Updates appear in the standard WordPress Plugins screen. No GitHub login, no FTP, no marketplace required.

Can I move a license to a different site?

Yes. Open Beaconry → Dashboard → License → Deactivate on the old site. The seat is freed within 1 hour. Activate the same key on the new site.

GDPR and privacy

Is Beaconry GDPR-compliant?

Beaconry gives you all the building blocks: consent gate, server-side hashing, no third-party tracker domains, encrypted credentials. GDPR compliance always depends on your full setup. You're responsible for your privacy notice, cookie disclosure and the lawful basis for processing.

What Beaconry handles for you:

• The bundled nl-data-gate consent banner respects EU "no implicit consent" rules. No event leaves the browser until the visitor accepts analytics.
• PII fields sent to Meta, TikTok, Google Ads, LinkedIn, Microsoft Ads, Pinterest, Snapchat, Reddit and X Ads (email, phone, name, ZIP, city) are SHA-256 hashed before transmission, per each platform's matching guidelines.
• Server access logs are kept 14 days max for security purposes only.

What data flows where?

From the browser:

• Consent state (nl_pref cookie) and click-IDs (nl_ext cookie) stay on your domain.
• Event metadata (URL, page title, user agent, referrer, scroll depth) gets sent to your WordPress install.

From WordPress to platforms:

• Event metadata, hashed PII and the per-channel click-ID (fbclid for Meta, ttclid for TikTok, gclid for Google Ads, msclkid for Microsoft Ads, li_fat_id for LinkedIn, _epik for Pinterest, sc_at for Snapchat, rdt_cid for Reddit, twclid for X Ads) are sent to the configured platform's official API.
• Each channel only receives data if you configured credentials for it. Disabled channels receive nothing.

What never leaves your WordPress:

• Raw email addresses or phone numbers (always hashed first).
• Your platform access tokens (encrypted in database, only sent server-to-server in HTTPS request headers).
• Your visitors' IP addresses are not transmitted to Beaconry's central servers (Beaconry does not have a central server that receives event data).

What does Beaconry's central worker know about my visitors?

Nothing. Beaconry's central Cloudflare Worker handles license validation and Google Ads OAuth proxying only. It never sees event data, never sees visitor info, never sees your platform credentials.

Where does my data live?

• WordPress database (your hosting): consent state, click-IDs, event log, encrypted platform tokens.
• Platform APIs (Meta, TikTok, Google Ads, LinkedIn, GA4, Microsoft Ads, Pinterest, Snapchat, Reddit, X Ads): their normal storage. Subject to each platform's data-processing agreements.
• Beaconry's central worker: only your license key and site URL.

Infrastructure

What versions of WordPress and PHP are supported?

WordPress 6.4 or newer, PHP 8.3 or newer. Beaconry uses modern type-hints and enums, older PHP versions will fail activation.

Which commerce plugins are supported?

WooCommerce, Easy Digital Downloads (EDD) and SureCart adapters all ship native. WooCommerce wires up the full ten-event funnel (view_item, view_item_list, view_cart, add_to_cart, remove_from_cart, search, begin_checkout, add_payment_info, purchase, refund) including classic + block checkout. Order events include line items, currency and value. Purchase events use a stable per-order event_id for browser-pixel deduplication.

Which form plugins are supported?

Seven form plugins ship with native adapters: Fluent Forms, Kadence Forms (both Blocks and Advanced), Contact Form 7, Elementor Forms, Gravity Forms, Ninja Forms and WPForms. Submissions auto-fire as generate_lead events with hashed PII (email, phone, name, ZIP) for matching. No JS-API wire-up needed for these plugins.

Can I run Beaconry alongside Google Tag Manager?

You can, but it's usually counter-productive. GTM serves the same purpose Beaconry serves. Beaconry replaces GTM. Running both means double tracking and adblockers will block your GTM-served pixels anyway.

Recommended: pick one. Beaconry if you want adblock-immune server-side dispatch, GTM if you have an existing tag-template setup you can't migrate.

Does Beaconry work in WordPress multisite?

Yes. Activate per-site (not network-wide) and configure each site's credentials independently. Each multisite blog counts as one activation against your tier seat count.

Does Beaconry work with caching and optimization plugins?

Yes. Beaconry automatically opts its tracking scripts out of the JavaScript optimizations that would otherwise stop tracking from firing on page load, using the exact exclusion mechanism each plugin documents. This is built in, you configure nothing, for:

• LiteSpeed Cache: JS combine, minify, defer, delay and Guest Mode.
• WP Rocket: Delay JavaScript Execution, the optimization that actually breaks tracking.
• SiteGround Speed Optimizer: JS async, minify and combine.
• Cloudflare: Rocket Loader.

Two cases need a one-time manual step, because the plugin offers no code-level exclusion hook, only a field in its own admin UI:

• WP Rocket "Combine JavaScript" (legacy, off by default on HTTP/2): if you enable it, add nl-data.js to WP Rocket's Excluded JavaScript Files field and NLData.init to Excluded Inline JavaScript (File Optimization tab).
• Cloudflare "Auto Minify": minification on its own does not break tracking (only Rocket Loader does, and that is handled automatically), so no action is usually needed.

Plain page caching (WP Super Cache, W3 Total Cache page cache, and similar) is always safe: Beaconry refreshes its security nonce on the client side, so a cached HTML page keeps tracking correctly.

Why is my refund missing from Meta or Google Ads?

This is intentional. Refund events go to GA4 only, because GA4 has a native refund event that nets the refunded revenue back against the original purchase. The ad channels (Meta, Google Ads and the rest) are skipped because none of them has a real refund event, so there is nothing meaningful to send them.

Can I track form abandonment?

Yes. Beaconry tracks per-form drop-off analytics via form_start, form_abandon and lead signals, so you can see where visitors give up before submitting. These are GA4-only analytics signals and they are PII-safe (no field contents are captured).

Can I track custom button or link clicks?

Yes. Click-Tracking lets you fire events on any element using five configurable CSS-class slots, plus data-bcnr-* attribute overrides for per-element control when a class is not enough.

Can I report multiple shop currencies as one?

Yes. Multi-currency reporting converts each order into your reporting currency using ECB daily exchange rates, so a shop that sells in several currencies reports as a single consolidated revenue figure.

Do EDD and SureCart get the same events as WooCommerce?

Yes. The Easy Digital Downloads and SureCart adapters fire the same commerce funnel as WooCommerce, minus the search event.

Roadmap and feedback

What's coming next?

See the roadmap. All ten server-side channels (Meta, TikTok, Google Ads, LinkedIn, GA4, Microsoft Ads, Pinterest, Snapchat, Reddit, X Ads) are live, Hybrid Mode rolled out to nine of them, plus live conversion dashboard, channel health score, anomaly detection with mail alerts and multi-currency reporting are all in production. Beaconry is production-ready and in active customer use, and the focus is public-launch polish and form-plugin adapter expansion (Bricks Forms, Spectra Forms, Forminator under evaluation).

How do I influence the roadmap?

Agency-tier customers have a direct line via email. Solo and Studio customers can email info@beaconry.app with feature requests. Items that come up across multiple customers go to the planned bucket faster.

Is there a public changelog?

Yes, beaconry.json always reflects the latest published version with version notes. The WordPress Plugins screen shows the same notes when an update is offered.