What Changed
How to use this page
Section titled “How to use this page”This page is a customer-facing summary of recent Lens for WordPress releases. Use it to:
- See what changed and decide whether to upgrade now or wait
- Understand which release introduced a specific behavior
- Find the upgrade notes that go with each release
It is not a full engineering changelog. For raw release notes, see the plugin’s repository or the WordPress.org plugin page.
Recent themes
Section titled “Recent themes”Across the most recent releases, the plugin has moved in three directions:
- Better WordPress-side configuration controls — fewer settings that require code changes, more controls surfaced in the WordPress admin UI.
- More explicit sync and connection feedback — clearer status indicators, more helpful error messages, and a visible Last sync time.
- Improved widget behavior — audience, layout, and theme controls that match the way real review and feedback workflows actually look.
Release history
Section titled “Release history”| Version | Date | Highlights |
|---|---|---|
| 2.4.0 | 2026-04-22 | Account-based connection flow is now the default. Workspace token entry moved behind a “legacy” tab. New Last sync time indicator on the Lens admin page. Improved error text for authentication failures. |
| 2.3.1 | 2026-03-05 | Fixed a regression where the widget could double-render when a theme also included a legacy Lens Inject snippet. Improved compatibility with popular page caches. |
| 2.3.0 | 2026-02-12 | New Floating + draggable layout option. Audience picker rewritten with clearer language (“Internal only” vs “All visitors”). Sync status now reports a dedicated |
| 2.2.0 | 2025-12-08 | Connection settings moved to a dedicated section on the Lens admin page. Improved handling of expired sessions — the plugin now surfaces a clear Disconnected state instead of failing silently. |
| 2.1.0 | 2025-10-21 | Introduced light/dark/system theme picker for the widget panel. Added the Enable widget master switch as a first-class control separate from audience. |
| 2.0.0 | 2025-08-04 | Major release: renamed to Lens for WordPress. Plugin admin page rewritten. Deprecated the standalone Lens Inject install path — see Legacy Lens Inject for migration steps. |
| 1.x | Through 2025-07 | Earlier releases focused on the original “Lens widget for WordPress” feature set. Customers on a 1.x release should plan to upgrade to 2.x; 1.x is no longer receiving fixes. |
Upgrade notes by major version
Section titled “Upgrade notes by major version”Upgrading to 2.x from 1.x
Section titled “Upgrading to 2.x from 1.x”- The plugin slug stays the same; standard WordPress in-place upgrade is supported.
- After upgrading, re-open Lens → Connection settings and confirm the connection is still healthy. Some 1.x installs need a one-time reconnect.
- Audience and layout settings are preserved across the upgrade.
- If you also run the old Lens Inject snippet in your theme, remove it during the upgrade — see Legacy Lens Inject. Running both produces a double-rendered widget.
Future major versions
Section titled “Future major versions”When a future major version ships, this page will document:
- Required minimum WordPress and PHP versions
- Any setting that needs to be reviewed after upgrade
- Any deprecated behavior and the timeline for removal
Related
Section titled “Related”- Install and Activate — current install path.
- Legacy Lens Inject — migration off the older install path.
- FAQ — common questions about plugin behavior.