1.2.7 - Apr 1, 2026
- Fix - Multisite network mode now performs periodic checks only on the main site and syncs shared network status metadata.
- Fix - Entry/export column registration now uses canonical
pb_ref_* keys only, preventing duplicate "Referral Tracker" columns after upgrading from legacy versions.
- Fix - Added one-time export migration to convert saved legacy numeric entry-grid columns to canonical
pb_ref_* keys and remove duplicates.
- Fix - Added one-time historical backfill for
wp_gf_entry_meta so missing/empty pb_ref_* rows are populated from legacy numeric tracking field values.
- Enhancement - Improved licensing integrity checks to keep runtime behavior aligned with current license entitlement.
- Enhancement - Preserved continuity for previously activated sites when licenses move to expired status.
- Enhancement - Added throttled/scheduled license revalidation with grace-window fallback for temporary API failures.
- Enhancement - License notices now clarify blocked states such as revoked keys and activation-limit failures.
- Enhancement - Added "Check License Now" action plus diagnostics for last check result, site usage count, and Brewhouse version.
- Enhancement - "Enable referral source tracking on all forms by default" now defaults to OFF on fresh installs and when no prior default is saved.
1.2.6 - Mar 12, 2026
- Fix - Historical Google Ads GCLID migration now retries safely and no longer marks migration complete when the SQL copy fails.
- Fix - Submission fallback now guarantees
Source and Referrer default values even when tracking hidden inputs are missing from POST.
- Fix - Entry edit restore safety-net now logs failures when a tracking field cannot be restored.
- Enhancement - Front-end tracking now falls back to
sessionStorage when cookies are unavailable or blocked.
- Enhancement - Admin users with
manage_options now use session-only tracking persistence for easier QA testing.
- Enhancement - One-time admin cleanup now clears legacy
pb-ref-tracking-* storage immediately after upgrade in session-only mode.
1.2.5 - Mar 2, 2026
- New - "Protect Scripts from Minification" option under Advanced settings adds data attributes to exclude tracking scripts from caching/optimization plugins (WP Rocket, LiteSpeed Cache, SG Optimizer, Autoptimize, Cloudflare Rocket Loader).
- New - Admin UI now displays the tracking JS file paths so users can manually exclude them in caching plugins.
- Enhancement - "Enable by Default" setting is now a checkbox with clearer guidance on all-forms behavior and per-form overrides.
1.2.4 - Feb 28, 2026
- New - "Remove Data on Uninstall" option under Data & Privacy settings. Unchecked by default — plugin data is preserved unless the user explicitly opts in before deleting.
- Fix - Uninstall now suspends
gform_form_post_get_meta before reading forms, preventing tracking fields from being permanently saved into form metadata during cleanup.
- Fix - One-time migration automatically removes any orphaned tracking fields that were accidentally saved into form metadata by earlier plugin versions.
- Enhancement - Consolidated hook-suspension logic into a single reusable helper for safer form metadata operations.
- Enhancement - Centralized built-in source lists into the Constants class, removing duplicate arrays across files.
- Enhancement - Removed unused
prop() method from Constants class.
1.2.3 - Feb 27, 2026
- Fix - Editing an entry in the admin no longer wipes tracking values or other form fields. Tracking fields are excluded from the entry edit screen so GF never overwrites real field values with empty POST data.
- Fix - A
gform_after_update_entry safety-net restores any tracking values that are still cleared during an entry edit.
- Enhancement - Tracking fields now use
GF_Field_Hidden instead of CSS-hidden text fields, reducing interference with third-party plugins.
1.2.2 - Feb 27, 2026
- Fix - Tracking field IDs are now rebuilt with canonical safe IDs on every render, preventing ID collisions with real form fields (email, phone, zip, etc.).
- Fix - Front-end field population restricted to plugin-owned inputs in the
218523x namespace to prevent values from being injected into unrelated fields.
- Fix - Google Ads Tracker migration now suspends
gform_form_post_get_meta so dynamically-injected fields are never saved into permanent form records.
- Fix - Entry list tracking columns now reject IDs outside the plugin namespace, preventing tracking data from replacing real field values in the Entries table.
- Fix - Tracking entry meta is no longer written for forms where tracking is disabled.
1.2.1 - Feb 24, 2026
- New - Click ID field and
{pb_ref_clid} merge tag captures the first detected click ID (gclid, fbclid, msclkid, etc.) for direct CRM mapping.
- Fix - Paid ad clicks now always force a full attribution update, even when a first-touch cookie already exists.
- Fix - UTM fields not present in a new paid visit are now cleared so stale values from a previous session cannot bleed through.
1.2.0 - Feb 20, 2026
- New - Custom Sources with label, match field, match type, match value, and priority ordering.
- New - Append Organic/Ads Labels setting for custom source labels.
- New - Tracking fields can be added as selectable columns in the Gravity Forms entry list.
- New -
pb_gforms_referral_tracking_loaded action for add-on bootstrapping.
- New -
pb_gforms_referral_tracking_custom_sources filter for programmatic custom source rules.
- Fix - Constant Contact, Salesforce, and HubSpot click IDs now correctly identified.
- Fix - Facebook
fbclid alone no longer classified as paid traffic.
- Fix - Tracking JS no longer initialised twice on multi-page forms.
- Fix - Click ID cookie now stores only the first detected ID.
- Fix - DuckDuckGo and Yandex organic traffic now correctly labelled.
- Fix - All plugin options properly removed on uninstall.
- Fix - Tracking assets no longer enqueued when Gravity Forms is not active.
1.1.5 - Feb 19, 2026
- i18n - Updated all translations. Added Filipino, Bengali (Bangladesh), and Urdu (Pakistan).
1.1.4 - Dec 12, 2025
- New - Merge tags for every tracking field (source, referrer, UTM params, click ID) in notifications, confirmations, and feeds.
- Enhancement - Merge tags only appear when tracking is enabled for the form.
1.1.3 - Nov 15, 2025
- Enhancement - Brewhouse licensing/updater updated to 1.3.1.
- Enhancement - Improved multisite activation logic.
1.1.2 - Nov 14, 2025
- Fix - License key/status cleared locally when remote deactivation fails so a new key can be entered immediately.
- Enhancement - Brewhouse 1.2.0 namespaced per-plugin to avoid cross-plugin collisions.
1.1.1 - Nov 12, 2025
- i18n - Refreshed all bundled translation files.
1.1.0 - Nov 10, 2025
- New - Network-mode deactivation with AJAX progress and automatic subsite license cleanup.
- New - Leave-page warnings during multisite license operations.
- Enhancement - DuckDuckGo and Yandex search traffic detection.
1.0.6 - Nov 7, 2025
- Enhancement - Brewhouse updater/licensing updated to 1.1.1.
1.0.5 - Nov 7, 2025
- New - Network Mode for unlimited licenses with chunked subsite activation and progress feedback.
- Enhancement - Tracking enabled immediately after activation without requiring a settings save.
1.0.4 - Nov 6, 2025
- New - GPL v3 license file.
- Enhancement - Features remain active without a license; only settings UI is gated.
- Enhancement - Network activation enables tracking across all subsites automatically.
- Enhancement - Single-site activation auto-enables the default setting.
1.0.3 - Oct 24, 2025
- Fix - Tracking fields no longer appear in the form builder or Site Editor preview.
1.0.2 - Oct 24, 2025
- Fix - Hidden tracking fields no longer add extra height to forms on the frontend.
1.0.1 - Oct 24, 2025
- New - AI assistant sources: ChatGPT, Perplexity, Copilot, Claude, Grok, DeepSeek.
- Enhancement - Gemini traffic attributed under Google.
1.0.0 - Sep 30, 2025