=== Nelio Session Recordings ===
Contributors: nelio, davilera, avillegasn
Donate Link: https://neliosoftware.com/session-recordings/
Tags: analytics, recordings, insights, sessions, mouseflow
Requires PHP: 7.4
Requires at least: 6.6
Tested up to: 6.9
Stable tag: 1.7.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Record everything visitors do on your website and learn more about your users


== Description ==

**PLAYBACK YOUR VISITORS ACTIVITY RECORDINGS LIKE A VIDEO THAT YOU CAN WATCH**

[Nelio Session Recordings](https://neliosoftware.com/session-recordings/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-session-recordings) helps you watch recordings of real user behavior on your site, including mouse movements, clicks, scroll events, and more. Learn what frustrates users and resolve issues early.

Automatically record everything your visitors do on your website. The sessions can be replayed, rewatched, and analyzed later. You can see exactly what they see, just like you’re sitting next to them.

Watch a replay of people navigating your website to see what’s preventing them from converting. See how people interacted with products, what they added to cart, and what kept them from buying.

**Nelio Session Recordings** is a great solution for UX designers, marketing professionals, customer support teams, and everyone who works with websites.

[MORE INFORMATION](https://neliosoftware.com/session-recordings/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-session-recordings) | [SUPPORT FORUM](https://wordpress.org/support/plugin/nelio-session-recordings/)


== Installation ==

**Installation through the WordPress Dashboard**

1. Login to your WordPress admin.
2. Click on the plugins tab.
3. Click the Add New button.
4. Search for “Nelio Session Recordings.”
5. Look for our plugin, click “Install Now” and then “Activate.”
6. Once the plugin is installed and active, you simply need to [get a license key](https://neliosoftware.com/session-recordings/pricing/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-session-recordings) to start recording your visitors.

And that’s it! You may now head to the new menu item on the left labeled “Nelio Recordings”.


**Alternative installation methods**

1. Download this plugin.
2. Login to your WordPress admin.
3. Click on the plugins tab.
4. Click the Add New button.
5. Click the Upload button.
6. Click “Install Now” and then “Activate.”


== Frequently Asked Questions ==

= What are sessions? =

A session is a visitor’s full journey on your site, including every page they visit. Every time a visitor comes to your site, we’ll record their journey and how they interact with your page.

= Why do I need session recordings? =

Marketing has become an extremely complex field, and it’s easy to feel bombarded with too much data. Over the years, we’ve built up a reputation for being simple, fast, and easy. With our plugin you can:

- Understand how customers browse your site.
- Identify where they’re getting stuck.
- Make quick changes that directly impact revenue.

Not to brag, but we have a LOT of expertise around [conversion rate optimization!](https://wordpress.org/plugins/nelio-ab-testing/)

= Will recordings slow down my website? =

Nope! Our frontend scripts won’t slow down site speed or performance for your visitors or customers.

= What’s the setup process like? =

We’ve made the setup as painless as possible. It’s a simple three-step process; install and activate Nelio Session Recordings in your WordPress site, introduce your [license key](https://neliosoftware.com/session-recordings/pricing/?utm_source=wordpressorg&utm_medium=referral&utm_campaign=nelio-session-recordings), and start recording sessions. Then it’s off to the races.

== Screenshots ==

1. **Player of session recordings**. Nelio Session Recordings includes a player to watch recorded sessions where your visitors click, scroll, and navigate, just as if you were standing right beside them.
2. **List of session recordings**. The list of recordings shows all the recorded sessions and allows you to sort by visitor location, browser, session duration, device, and more.
3. **Nelio Session Recordings Settings**. The settings provide ways to configure how the plugin tracks and records sessions.
4. **Privacy-first session recordings**. As any input element is highly likely to contain sensitive text such as email or password, Nelio Session Recordings mask these by default.

== Changelog ==

= 1.7.0 (April 8, 2026) =
* Reduce noisy session recording mutations caused by class and style churn on animated pages.
* Improve session recording performance by batching mutation events and reducing sync frequency.
* Protect recording delivery by keeping pending events in local storage until they are successfully sent.
* Improve support for animated elements and reduce replay issues on sites using libraries such as AOS, WOW.js, and GSAP.


= 1.6.0 (January 29, 2026) =
* Fix indexed DB usage on Firefox.
* Fix recordings scope definition to correctly apply configured URL and selector settings, preventing unintended sessions from being recorded.
* Fix minor security issue.

= 1.5.0 (May 5, 2025) =
* Add setting to exclude recordings on specific CSS selectors.
* Fix compatibility with super admin users in multisite installations.
* Update plugin dependencies.

= 1.4.1 (December 27, 2024) =
* Fix notice loading translations too early.

= 1.4.0 (August 30, 2024) =
* Add new scope setting to track recordings on a subset of URLs.

= 1.3.0 (June 19, 2024) =
* Track rage clicks on new session recordings.
* Track page reloads on new session recordings.
* Track U-turns on new session recordings.
* Add filter to manage session recordings with rage clicks.
* Add filter to manage session recordings with dead clicks.
* Add filter to manage session recordings with page reloads.
* Add filter to manage session recordings with U-turns.
* Add deactivation process to clean the plugin data.
* Show rage clicks on actions list.
* Show page reloads on actions list.
* Show U-turns on actions list.
* Show visits and conversions on actions list.
* Improve detection of non-clickable elements.

= 1.2.0 (April 30, 2024) =
* Add filter to manage session recordings for clicked elements.
* Add filter to manage session recordings for A/B testing data.
* Add new filter `neliosr_is_visitor_recorded`.
* Add setting to overwrite default behavior of Nelio A/B Testing GDPR tracking cookie.
* Play click audio when a click event is replayed.

= 1.1.0 (April 3, 2024) =
* Add filters to manage session recordings.
* Add delete action on session recording player.
* Improve integration with Nelio A/B Testing: session tracking starts when the alternative content is already loaded.

= 1.0.3 (March 4, 2024) =
* Fix link to terms and conditions.
* Fix menu icon.
* Fix detection of subscription with addon.

= 1.0.2 (February 27, 2024) =
* Fix issue with multisite installations.

= 1.0.1 (February 26, 2024) =
* Improve integration with Nelio A/B Testing.
* Show examples of session recordings.

= 1.0.0 (February 13, 2024) =
* **First version.**

== Upgrade Notice ==

= 1.7.0 (April 8, 2026) =
Several improvements and minor fixes.
