=== Microsoft Clarity ===
Contributors: sammartin,zoe7633,q3ahmed
Tags: Microsoft, Clarity, behavioral analytics
Requires at least: 4.0
Tested up to: 6.9.1
Stable tag: 0.10.23
License: MIT
License URI: https://docs.opensource.microsoft.com/content/releasing/license.html

How do you make your website great? Clarity can help you quickly see what's working on your site and where people get stuck. And it's free.

== Description ==

Clarity is a free behavioral analytics tool that helps you see what’s working on your site and where people get stuck. With features such as session recordings and heatmaps, you’ll gain a deeper understanding of how your users interact with your site, and get clear insights on how to improve your design to grow revenue and increase user retention.

**Session recordings** allow you to examine user behavior as it happened. You'll see where things are working smoothly and where your users drop off.

**Heatmaps** show you where your users clicked and scrolled, and how they moved around your site. You'll discover which parts of the page drive the most engagement and which parts get less traffic.

**Insights** help you make data-driven decisions to streamline your design. Zero in on relevant user sessions and root out problems like clicks that go nowhere, rage clicks, and excessive scrolling.

**Clarity chat** allows you to interact with Clarity through an intuitive conversational interface to get insights and recommendations using Copilot.

Get **Clarity Copilot summarized insights from heatmaps** to quickly understand user behavior patterns.

Receive concise summaries of session recordings to identify key user interactions and issues efficiently using Clarity Copilot.

The **metrics dashboard** offers a visual overview of your site's performance, popular pages, and insights about your users, such as where they're from and which devices and browsers they use.

**Privacy matters.** By default, Clarity masks sensitive content such as personal user information before it's uploaded. This means no sensitive text is ever sent to our servers.

**Built to grow with your business.** Clarity can scale to support even the largest websites, processing more than a petabyte of data from over 100 million users per month. And it won't get in the way of your site's performance.

**Stop guessing and get Clarity.** Setup is easy. You can start monitoring activity in minutes.

Review our [Privacy Policy](https://www.microsoft.com/en-gb/privacy/privacystatement) and [Legal Terms](https://clarity.microsoft.com/terms) for more details.


== Installation ==

Installation has never been easier. No action is required on Clarity site.

The plugin is inclusive, you can create a new project or connect to an existing one whether you're signed up or a new member.

Just install the plugin and start using Clarity on Wordpress.

### Installing the plugin

* Log in to the WordPress admin panel. Select **Plugins > Add New**.
* Search for Microsoft Clarity.
* Select **Install Now > Activate**.
* Open Clarity plugin from the NavBar.

Now you're ready to connect to Clarity on Wordpress.

#### Contact us

Contact us on clarityms@microsoft.com for support.

== Frequently Asked Questions ==

= What is Clarity? =

Clarity is a user behavior analytics tool that helps you understand how users are interacting with your website. Supported features include:

* Session recordings
* Heatmaps
* Insights

= Why should I use Clarity? =

Clarity helps you to better understand your users—what they like and what they don't.

Some highlights:

* Clarity is easy to customize to fit your business.
* Data is analyzed and ready to view in near-real time.
* Clarity won't get in the way of your site's performance.
* There are no limits on the number of sites per account. Clarity can scale to support even the largest websites.
* Clarity can process more than a petabyte of data from over 100 million users per month. T here are no traffic limits on these sites.
* Insights, powered by AI and machine learning, help you analyze the user behavior efficiently and quickly.
* No sampling.

= How much does Clarity cost? =

It's free!

= OK, so how does Clarity work? =

Visit [Clarity homepage](https://clarity.microsoft.com?utm_medium=wordpressInstallStepsPluginPageFAQ&utm_source=wordpressPlugin) for more info. You can also try a [live demo](https://clarity.microsoft.com/demo/projects/view/3t0wlogvdz/dashboard?date_d=Last%203%20days&utm_medium=wordpressInstallStepsPluginPageFAQ&utm_source=wordpressPlugin) to see sample session recordings, heatmaps, and more.

Check out more [frequently asked questions](https://docs.microsoft.com/en-us/clarity/faq) and our [documentation](https://docs.microsoft.com/en-us/clarity/faq).

== Changelog ==
= 0.10.23 =
* Bugfix.

= 0.10.22 =
* Performance improvements.

= 0.10.21 =
* Adding Brand Agents support.

= 0.10.20 =
* Plugin improvement and bugfix.

= 0.10.19 =
* Bugfix.

= 0.10.18 =
* Plugin improvements.

= 0.10.17 =
* Analytics bugfix and improvements.

= 0.10.16 =
* Analytics improvements.

= 0.10.15 =
* Bugfix.

= 0.10.14 =
* Bugfix.

= 0.10.13 =
* Bugfix.

= 0.10.12 =
* Bugfix.

= 0.10.11 =
* Plugin improvements.

= 0.10.10 =
* Plugin improvements.

= 0.10.9 =
* Analytics improvements.

= 0.10.8 =
* Performance improvements.

= 0.10.7 =
* Minor fix.

= 0.10.6 =
* Performance improvements.

= 0.10.5 =
* Analytics improvements.

= 0.10.4 =
* Update Clarity iframe query params, redirect on activate.

= 0.10.3 =
* Update plugin description and the Setup Clarity notice.

= 0.10.2 =
* Fix issues with plugin activation, deactivation, and deletion in multisite installations.

= 0.10.1 =
* Fix WordPress site id becoming empty for multisite installations.
* Refactor code in clarity.php and fix linting issues

= 0.10.0 =
* Add integrate with Clarity hook for external plugins. See [Terms of use](https://clarity.microsoft.com/terms)

= 0.9.4 =
* Fixed a cross-site scripting vulnerability.

= 0.9.3 =
* Fixed some bugs and updated project settings so that only WordPress admins can change their Clarity project.

= 0.9.2 =
* Bug fix for PHP versions older than 7.2.

= 0.9.1 =
* Moved menu item to a more appropriate position.
* Fixed the Setup Clarity notice always appearing for some users after setup.

= 0.9.0 =
* Created a menu item for Clarity to be available for most Wordpress users not just admins.
* Users are now able to sign in to Clarity and view Clarity dashboard on WordPress without needing to go to Clarity site.

= 0.8.0 =
* Ability to create a new Clarity project and connect to it on WordPress without needing to go to Clarity site.
* Ability to connect to an existing Clarity project on WordPress without needing to go to Clarity site.
* Ability to sign up to Clarity on WordPress without needing to go to Clarity site.

= 0.7.5 =
* Minor fix.

= 0.7.4 =
* Minor fix.

= 0.7.3 =
* Minor enhancements.

= 0.7.2 =
* Minor enhancements.

= 0.7.1 =
* Update readme.

= 0.7 =
* Minor enhancements.

= 0.6 =
* Minor enhancements.

= 0.4 =
* Bug fixes.

= 0.3 =
* Compatibility with the latest WordPress version (v5.7).

= 0.2 =
* Details and Installation instruction updates.

= 0.1 =
* Initial release.

== Upgrade Notice ==

= 0.8.0 =
Create a new Clarity project or connect to an existing one without having to go to Clarity Site whether you're signed up or a new member.
