=== Nelio A/B Testing – AB Tests and Heatmaps for Better Conversion Optimization ===
Contributors: nelio, davilera, avillegasn
Donate Link: https://neliosoftware.com/testing/
Tags: a/b testing, conversion optimization, heatmap, multivariate test, cro
Requires PHP: 7.4
Requires at least: 6.7
Tested up to: 7.1
Stable tag: 8.5.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A/B Testing, conversion rate optimization, and beautiful Heatmaps with AI Assistance.

== Description ==

**Test, learn, and grow with data-driven insights**

[Nelio A/B Testing](https://neliosoftware.com/testing/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing) is an extremely powerful and easy-to-use **A/B Testing and Conversion Optimization plugin** for WordPress. Create, manage, and analyze tests directly from your WordPress dashboard — **no external tools, coding, or data exports required**.

With Nelio A/B Testing, you can test **pages, posts, headlines, menus, widgets, WooCommerce products, themes, CSS, synced patterns, and more**. Understand how visitors behave with **heatmaps, clickmaps, and scrollmaps**, and make data-driven decisions that actually improve conversions.

> _“Nelio A/B Testing has been a game changer for our web strategy. It empowered us to make decisions based on data, not instinct. The simplicity, affordability, and impact have been exceptional.”_
> _Quentin Molinié, Co-founder of [Darwin Nutrition](https://neliosoftware.com/blog/guardian-recovery-and-nelio-ab-testing-a-case-study/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing)_ | [_Case Studies_](https://neliosoftware.com/blog/tag/interviews/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing)

== 🚀 Why Choose Nelio A/B Testing? ==

- **Built for WordPress.** Unlike external SaaS tools, Nelio integrates natively into your dashboard and page builder for a seamless experience and instant setup.
- **Data-Driven Decisions, Simplified.** Design tests, view results, and apply winners automatically, all without writing a single line of code (if you don’t want to).
- **Privacy & Performance First.** No personal data stored and fully compatible with caching and optimization plugins.
- **We Listen and Evolve.** Your feedback directly shapes our roadmap. If you need a feature, tell us, and we’ll do our best to make it happen.

== 💡 Features at a Glance ==

1. **A/B and Multivariate Testing.** Test completely different layouts or subtle design tweaks to find out what converts best.
2. **Heatmaps & Scrollmaps.** Visualize how users interact with your content.
3. **Automatic Winner Deployment.** Let Nelio automatically apply the best-performing variation for you.
4. **WooCommerce Ready.** Test product titles, images, prices, and layouts to maximize sales.
5. **AI-Assisted Test Suggestions.** Get personalized test ideas to improve engagement and conversion.
6. **Segmentation & Targeting.** Test experiences by device, referrer, location, or behavior.
7. **GDPR & Privacy-Friendly.** No personal data stored, fully compliant with EU regulations.
8. **Performance-Aware.** Optimized for caching and minimal page load impact.
9. **Detailed Reports with Comprehensive Analytics.** Conversion rates, confidence levels, and visitor stats.
10. **Compatible with Page Builders.** Works with Gutenberg, Elementor, and more.
11. **Multisite & Localization Support.** Fully compatible with multisite networks and translated into multiple languages.
12. **Actively Maintained & Supported.** Frequent updates, detailed documentation, and responsive support.

== 🧪 What You Can Test ==

- Pages and Posts
- Headlines
- Content Templates
- WordPress Synced Patterns
- Menus and Widgets
- WooCommerce Products and Pricing
- Custom JavaScript and CSS Snippets
- Entire Site Designs
- Custom Post Types
- Popups
- PHP Hooks (for devs)

== 🔒 GDPR-Compliant & Privacy-Friendly ==

We take privacy seriously. Nelio A/B Testing **does not store personal data** and complies with the **GDPR** and the **CCPA**. You can use it confidently in any region.

== 💰 Free vs Premium ==

Start with the **free version** (supports up to [500 tested page views per month](https://neliosoftware.com/testing/help/what-is-a-tested-page-view/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing)) to run basic tests and heatmaps on smaller sites. [Upgrade to a **premium plan**](https://neliosoftware.com/testing/pricing/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing) to unlock advanced features, higher traffic limits, and priority support.

[youtube https://www.youtube.com/watch?v=20ODLEGbP8c]

**Nelio A/B Testing — The native WordPress solution for A/B testing, heatmaps, and conversion optimization.**

== Installation ==

1. Go to **Plugins → Add New** in your WordPress admin panel.
2. Search for “Nelio A/B Testing.”
3. Click **Install Now** and then **Activate**.
4. Follow the setup wizard.
5. Go to the **Account** page and add your License Key to enable Premium features (optional).
5. Start your first test under **Nelio A/B Testing** in the WordPress menu or read our [Getting Started Guide](https://neliosoftware.com/testing/getting-started-guide/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing) to cover the basics.

== Frequently Asked Questions ==

= Does Nelio A/B Testing slow down my site? =

Barely. All heavy processing happens on our servers, and the plugin integrates with major caching plugins to minimize load.

= Can I use it with page builders like Elementor or Gutenberg? =

Yes. Nelio A/B Testing works with all major page builders, including Elementor and the WordPress block editor (Gutenberg).

= How many tests can I run on the free plan? =

As many as you want. However, keep in mind that the free plan supports a limited number of page views per month, which means you should probably focus your efforts on one test only. Upgrade to premium to test high-traffic sites, run tests with more variants, and unlock additional premium features.

= Is my data safe? =

Absolutely. No sensitive or personal user data is stored or transmitted to our cloud.

= How often do you release updates?

We release new features and bug fixes regularly, ensuring full compatibility with the latest WordPress versions. Also, if you have specific needs or feature requests, [we’d love to hear from you](https://neliosoftware.com/testing/contact/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing), as we actively listen to user feedback and continuously shape our roadmap to bring your ideas to life.

= Where can I get help? =

You can get help here:

- 📖 [Official Documentation](https://neliosoftware.com/testing/help/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing)
- 💬 [Support Forum](https://wordpress.org/support/plugin/nelio-ab-testing/) and [Contact Form](https://neliosoftware.com/testing/contact/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-ab-testing)
- 🌐 [Nelio A/B Testing Website](https://neliosoftware.com/testing/)

= Where do I report security bugs found in this plugin? =

Please report security bugs found in the source code of the Nelio AB Testing plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/9e5fb36f-331a-424a-a9f2-e3dc70ec026c). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.

== Screenshots ==

1. Monitor and track the progress of your tests easily. Our results page offers an intuitive user interface that helps you to focus on what really matters.
2. Create tests quickly and effectively from WordPress. The user interface follows the new design guidelines introduced by Gutenberg.
3. Nelio A/B Testing supports different types of tests so that you can be more precise with your tests and goals.
4. Nelio AI jumpstarts your optimization process by analyzing your site and suggesting high-impact test ideas tailored to your content—so you can start testing smarter, faster.
5. The plugin comes with an overview page that shows you all the information you need about your running tests at a glance.
6. Our service lets you analyze the hottest areas of any page on your site so that you can understand your customers better.
7. Not only does the plugin include heatmaps, but it also features scrollmaps and confetti maps.

== Changelog ==

= 8.5.3 (August 27, 2026) =
* Aggregate test results by day, week, or month.
* Avoid registering click event listeners when no click or external link actions are configured.
* Fix loading animation in the “Add Test” popover when creating a new test.
* Fix page view tracking in heatmap tests.
* Fix recently finished results on the Overview screen when the winner is the control.
* Fix some UI labels so they can be localized.
* Fix page view count for paused tests in the experiment list.
* Hide the “Apply” button in the public results view.
* Hide the “Apply” button in the results view when the user doesn’t have the `edit_nab_experiments` capability.
* Hide the “Create Test” buttons when the user doesn’t have the `edit_nab_experiments` capability.
* Improve accessibility of Performance Analysis charts.
* Improve styling in segmentation section of test editor.
* Improve the appearance of Nelio AI’s suggested tests.
* Remove invalid assertion from recommendation engine endpoint.
* Replace tour bullets with step indicator in tutorials.
* Tweak heatmap metrics in Overview screen.
* Tweak the Overview screen to hide results until enough data is available.
* Use the current user in test previews for tests requiring logged-in users in one of its segments.

= 8.5.2 (July 31, 2026) =
* Fix REST request detection.
* Fix WooCommerce order value calculation when the store uses WooCommerce Blocks.

= 8.5.1 (July 30, 2026) =
* Add new settings in test editor to customize Google Analytics tracking.
* Add “Extended view” in Overview’s “Running tests” to load old UI.
* Fix normalized URLs in conversion action scopes.
* Include heatmaps in new Overview screen.
* Show latest three running tests and heatmaps in Overview screen.

= 8.5.0 (July 20, 2026) =
* Add filter `nab_can_{$experiment_type}_be_started` to check if a test can be started.
* Add filter `nab_get_testable_custom_post_types` to customize testable custom post types.
* Allow restricting page view tracking to subset of test scope.
* Boost available quota for new users during their first 14 days.
* Fix _Google Analytics_ tracking setting.
* Fix _Traffic Analysis_ setting.
* Fix to ensure automatic goals remain first when sorting goals.
* Make excluded IPs available to everyone.
* Move heatmaps local directory from `WP_CONTENT_DIR` to `wp_get_uploads_dir()`.
* New overview screen.
* New welcome screen.
* Optimize page attributes by setting value in store and prevent re-renders.
* Prevent unauthorized requests to Nelio A/B Testing’s API.
* Refactor code editor into its own package to fix issue with i18n strings.
* Show estimated page views to reach 90% confidence.
* Store site URLs using a home URL placeholder.

= 8.4.1 (June 17, 2026) =
* Make excluded IPs available to everyone.
* Track experiment status in Nelio’s cloud.

= 8.4.0 (May 20, 2026) =
* Add compatibility with WordPress 7.0.
* Add new option in WooCommerce Goals to track total order value instead of tested product revenue only.
* Add support for custom traffic allocation across variants.
* Add support for reordering goals and segments via drag and drop.
* Add support for reusable goals and segments.
* Fix bug with preloading query args.
* Fix CSS visual editor to maintain selected background image.
* Fix position slider in CSS visual editor to properly use selected unit.
* Fix invalid SQL “IN” on WooCommerce Order edit screen. Thanks [@svenms](https://wordpress.org/support/topic/bug-report-invalid-sql-in-on-woocommerce-order-edit-screen/).
* Fix HTML format issues in CSS+Text tests so that they’re no longer removed.
* Fix styles in contact us form.
* Fix styles in results page.
* Improve compat with Speed Optimizer by SiteGround.
* Improve reload speed when changing variant in debug tool.
* Rename “Help” page as “Documentation.”
* Tweak styles to match WordPress 7.0 colorscheme.

= 8.3.5 (April 23, 2026) =
* Fix template selection in template tests.

= 8.3.4 (April 20, 2026) =
* Fix encoding bug in external script setting preventing other settings from loading.

= 8.3.3 (April 16, 2026) =
* Fix alternative content sanitization in CSS and Text tests.

= 8.3.2 (April 15, 2026) =
* Add underlying error code and message when quota retrieval fails.
* Fix heatmap display in heatmap-only tests.

= 8.3.1 (April 14, 2026) =
* Fix type error by checking for failed cached data retrieval in experiment manager.
* Fix fatal error when calling `nab_get_running_experiments` on `null`. Reported by [@hannah3405](https://wordpress.org/support/topic/fatal-error-with-8-3-0/).

= 8.3.0 (April 13, 2026) =
* Add logic to reset `nabAlternative` cookie when starting a new set of tests.
* Add nonce to CSS and JavaScript alternative previewers to prevent unauthorized users from using them.
* Add nonce to CSS selector finder to prevent unauthorized users from using it.
* Add support for WPC Product Bundles for WooCommerce.
* Enhance IP validation logic in excluded IPs setting.
* Fix access to “My Account” subpages in WooCommerce when there are active tests.
* Fix alternative theme selector in theme tests.
* Fix bug when REST proxy is enabled. Result from cloud should be properly forwarded, but it wasn’t.
* Fix post type exclusions in custom post type tests.
* Fix select menu placement near viewport edge.
* Fix welcome guides to auto-open on first UI visit.
* Prevent alternative loading content in a tested URL with no testing query argument.
* Prevent auto-opening of remaining welcome guides after one is skipped (still accessible manually).
* Reduce public script bundle size by 65%.
* Remove unused code from PHP alternative previewer.
* Update TS config target to ES2020.

= 8.2.8 (February 23, 2026) =
* Add quality check to prevent starting JavaScript tests when `done()` is missing in variants
* Enable `php-snippet` scope rules on PHP tests only.
* Enable variant switcher in heatmap results page when current variant has no heatmap data.
* Ensure the CSS preview iframe always includes the `nab-css-preview` query parameter.
* Ensure the JavaScript preview iframe always includes the `nab-javascript-preview` query parameter.
* Fix conversion rate value in Results screen. It should contain the percentage symbol.
* Fix incorrect type for `Experiment.startDate` in JavaScript.
* Fix JavaScript warnings with deprecated features in WordPress.
* Fix style detection on CSS editor for elements that have hover/active rules.
* Fix validation of YouTube Video conversion actions.
* Tweak editor UI to highlight invalid conversion actions and invalid segments.

= 8.2.7 (February 2, 2026) =
* Fix conversion tracking in Google Analytics when triggered by WooCommerce.

= 8.2.6 (January 29, 2026) =
* Fix post selector bug to make sure selected content is properly displayed.

= 8.2.5 (January 29, 2026) =
* Fix scope in settings screen to remove error messages from other plugins.
* Fix synced pattern tests. Alternative patterns should be loaded not only when they’re not embedded directly in the page, but also when they’re a child of another block.
* Fix vulnerability in post searcher.
* Remove unnecessary attribute from WooCommerce order action.
* Remove unnecessary helper function in synced pattern tests to simplify code.
* Reorganize source code.
* Tweak Nelio A/B Testing’s box in WooCommerce orders to show only experiments that track WooCommerce orders and use only those goals to determine its sync status.

= 8.2.4 (January 19, 2026) =
* Fix alternative template loading when using WordPress templates.
* Fix loading of alternative excerpts in `core/post-excerpt` blocks.

= 8.2.3 (January 12, 2026) =
* Fix infinite loop when loading alternative excerpts.
* Fix pagination on tested Elementor pages (e.g. when using Posts widget).
* Fix warning on fresh installation. Thanks [@Orestis Samaras](https://wordpress.org/support/topic/warning-trying-to-access-array-offset-on-value-of-type-null-6/).

= 8.2.2 (December 23, 2025) =
* Add GTmetrix in bot detection.
* Add Nelio A/B Testing commands to the WordPress Command Bar.
* Add `console.info` message if a variant doesn’t invoke `done()` when it’s supposed to.
* Add new statuses `missing-session` and `awaiting-variant` in `nab.session()`.
* Add revenue per view when hovering revenue value in test results.
* Fix GDPR Cookie detection when its value should be decoded.
* Fix Polylang integration when resolving localized homepage for tests.
* Fix alternative Nelio Popup loading.
* Fix buttons in contextual help.
* Tweak Nelio Popup label in popup tests.
* Tweak `nab_get_queried_object_id` to be able to find queried post ID with unknown type.

= 8.2.0 (December 2, 2025) =
* Add setting to choose GA4 event tracking method (Google Tag Manager or gtag.js) for improved compatibility with GTM-based and direct gtag implementations.
* Add external script to load alternative content on embedded external pages.
* Fix compatibility with third-party forms in form submission conversion actions.
* Fix potential security risk by granting default permission to edit PHP tests to admin users only.
* Internationalize some labels.

### 🌍 Translations

Available in English, Spanish, and Catalan.
Want to help translate Nelio A/B Testing into your language? [Join the translation team!](https://translate.wordpress.org/projects/wp-plugins/nelio-ab-testing/)

== Upgrade Notice ==

= 8.5.3 (August 27, 2026) =
Several improvements and bug fixes.
