Changelog

WPLytic 4 adds bot analytics, period comparisons, saved AI conversations, and more control over your account and reports.

New

• Account security: Protect your account with two-factor authentication and recovery codes. Review active device sessions and security logs.
• API access: Create API tokens with explicit read permissions for integrations.
• Bot analytics: View crawler and browser automation activity separately from human visitors.
• Period comparisons: Compare statistics with the previous period or the previous year.
• Visitor drilldowns: Open the visitors behind a statistic or conversion goal.
• Page performance: See page-load performance statistics alongside your traffic data.
• Saved Ask AI conversations: Return to previous questions, queries, and results. Cancel a request and use expanded model settings.
• Saved reports across devices: Keep your segments, goals, filters, and Stats layouts with your account.
• Exclusion filters: Exclude selected IP addresses, pages, tags, countries, and referrers from a segment.
• Complete top lists: Search and page through the full lists of top pages, referrers, and countries.
• Scheduled tasks: Schedule tasks and manage notification groups, including Telegram notifications.
• WordPress tracking controls: Choose whether to track category archive pages.
• Localized countries: View and search country names in your dashboard language.
• Visited pages: Search the pages visited during a session.
• Database optimization: Review database settings and optimization guidance. An optional local command can apply tuning changes.

Improvements

• Clearer settings, improved mobile controls, and more consistent dark mode.
• Smoother Visitors table scrolling, row sizing, pagination, and caching.
• More accurate session boundaries based on real visitor activity.
• Clearer chart loading states and empty results.
• Stronger password handling and more consistent API authentication and permission checks.
• Improved update validation, progress reporting, rollback, and WordPress upgrade handling.
• Sign in and complete updates with your WordPress administrator account. Return to WPLytic after WordPress login, with existing accounts and two-factor authentication preserved.

Before you update

The archive includes country-level GeoIP data only. For city-level locations, download the city database from Settings.

Back up your database and installation files. Test this major update on a copy of your site first. WPLytic 4 requires 64-bit PHP 8.3 or later and MySQL 8.0 or later, or MariaDB 10.7 or later. Use the package that matches your single-site or multi-site license.

New

• Domains: You can now sort domains by name, visitors in the last 24h, or online visitors.
• Domains: Added domain name filtering.
• Domains: Added option to set or disable auto-refresh interval.
• Ask AI: Added support for GPT-4.1, GPT-4.1-mini, and GPT-o4-mini.

Improvements

• Ask AI: Improved chart generation (e.g. “visits per hour”).
• Ask AI: Improved follow-up questions logic.
• Ask AI: Reduced SQL errors.
• UI: Updated “Track new domain” button style and position.

Bug fixes

• Fix: Error Tracking setting no longer defaults to always on.
• Fix: More accurate i18n plural localization.
• Fix: Compatibility issue when updating from versions without Error Tracking.

New

• Error Tracking: You can now track and view JavaScript errors for each user session.
• Custom Layouts: Added the ability to resize and re-order the widgets/charts in the Stats screen. You can drag cards by their title.

Improvements

• Performance: Improve loading performance when going to the visitors screen for a specific domain from the domains screen.
• Stats: Changed the way how Bounce Rate is calculated. Previously, all sessions with 1 page were considered as “bounced”, but this doesn’t reflect engagement well. Now, if a session is longer than 10 seconds, it will be considered as “engaged”. Expect the new bounce rate to show lower, more accurate values.
• UI: Simplify Goal block design (only show Goal segment total count when hovering the conversion rate percentage).
• UI: Left-align the content displayed in Events list.
• UI: Improved Goal blocks design.
• UI: Update dashboard styling and theme colors, to reduce contrast and make it easier on the eyes.
• UI: Numbers in the Stats panel are now displayed in a compact mode (e.g. 8.1k instead of 8103), hover to see the original value.
• UI: Visitors list – Improve readability by left-aligning all columns.
• UI/UX: Segments – When converting a Goal back into a Segment, make the Segment inactive by default. This prevents other stats blocks from changing in size (when a segment is enabled).
• UI: Stats – Make Top Referrers list height same as Top Countries and Top Pages.
• UI/UX: Add button to go to the updates page from the “update available” notification.
• UI: Simplify updates screen and make it easier to read.
• UI: Improved Visitors table row readability and spacing.
• UX: For the Visitors table, persist locally the selected table density option.
• UX: Page chips can now be right-clicked or middle-clicked to open the pages in a new tab.
• UX: Referrer chips can now also be opened in a new tab when shown in the segments header.
• Dev: Updated all JS packages.
• Dev: Updated all packages to latest versions (including React 18 → 19)

Bug fixes

• Fix “Visitors” button in Domains screen, sometimes not redirecting to the selected domain.
• Fix history/back button after clicking the “Visitors” link in the Domains screen (same location was added twice in history).
• Fix Goal block title layout when using a long Goal name.
• Fix localization plurals (i18n v23 → v24 changed to Intl pluralization).
• Fix updater is_writable check, which might incorrectly say file permissions are wrong when trying to update WPLytic.
• Fix some stats loading bar display issues.
• Fix link to OpenAI API pricing page (they changed it).
• Fix some issues with the French locale.

Bug fixes

• Fix plugin not working on some hosting instances where DBHOST env variable is declared globally.

New

• Ask AI Charts: You can ask the AI to generate charts and also download them.
• Device type filter: You can now filter a segment on “Desktop” or “Mobile” devices.
• Japanese language

Improvements

• UI: Improve goal block UI when only ALL segment is visible.
• UI: Improve number block UI in stats.
• UI: Improve Domains page layout and domain card UI.
• If only one domain is shown, make the domain card full-width.
• Update internal JS packages to latest versions.
• Translations: Add some missing translations and update a few wrong ones.

Bug fixes

• Fix error being shown in the console when website is accessed by a bot (e.g. Google bot).
• Charts: Fix chart start/end dates when the server’s timezone is different from client’s.
• UI: Fix stats card alignment when only one goal is visible.
• AskAI: Fix chat history when using PHP get_magic_quotes_gpc enabled.

New

• Ask AI: Setting to include chat history. This allows for follow-up questions.
• Ask AI: Button to ask the AI to fix the SQL error, if the latest query execution resulted in one.
• Ask AI: Added GPT o1 and o1-mini models support (early access required).

Improvements

• Ask AI: Better handle Ask AI GPT error responses.
• UX: Added “Copy” button to snackbar notifications (for errors only).
• UX: Better dark mode settings: you can now set the color scheme back to ‘system’ also (previously, once set, it was either ‘light’ or ‘dark’)
• UX: Clear All segment IP filter after deleting all sessions for specific user IP.

Bug fixes

• Ask AI: Fix execution query output when selecting data from database that is in a binary format.
• Fix a bug in the Visitors screen, where the list of visited pages for a session was out of order when the session had both multiple Events and multiple Tags.

New

• Session timeout – If a user leaves your site in a background tab for more than 30 minutes, when they come back to the tab, a new session will be created instead of continuing the previous one. This should reduce the number of very long (1h+) sessions.
• WPLY.trackNewPage() – New JS API function that triggers a new pageview. Useful for tracking SPA applications.

Improvements and fixes

• Migrate from Moment.js to Day.js (modern, efficient and better maintained).
• Update JavaScript packages to latest versions.
• Ask AI: Pass current date to AI. Asking questions like “visitors in June” now returns data for June of this year.

Bug fixes

• Possibly fix an updating issue where the integrity hash value for the new version was returning an older cached value, thus preventing the update process.
• Potentially fix most issues with long session lengths.

Single-site version only

Fix latest version check when latest version number is different than the multi-site version.

Single-site version only

Fix segment filters and goals for single-site version.

Add support for the new OpenAI project API keys format.

This update includes fixes and improvements. Please re-download the GeoIP City database.

Improvements and fixes

• Ask AI: Add GPT4o and GPT4o-mini models.
• Ask AI: Always display selected model in chat header.
• Ask AI: Improve prompts/responses.
• UI: Improve consistency – make top countries flags clickable chips.
• UI: Always display full IP in visitors list (if not hashed or censored), instead of only the last 6 characters.
• Update GeoIP databases to August 2024 versions.
• Better handle the downloading of GeoIP databases. Make sure tracking doesn’t break if the GeoIP database is corrupt.
• Fixed missing remote GeoIP city database. Please re-download the GeoIP City Database (Settings → Tracking Download City GeoIP Database).
• Fixed censorIP sometimes still displaying IP in tooltip.

This is a major update that includes new features (Goals/Ask AI), UI improvements, performance improvements and bug fixes.

New

• 🥳 Goals: A segment can now be converted to a goal. Goals help you find the amount of and conversion rates for specific user behaviors within specific user segments.
• 🥳 Ask AI: ChatGPT integration: You can ask the AI questions about your data.
• 🥳 Multi-domain filtering: The segments header is now also displayed on the main domains page.
• 🥳 Smart auto chart granularity: The granularity of charts automatically switches to a better value.
• 🥳 Setting to include or not the URL fragment (#hash part) when saving URLs in the database. Useful for when using a SPA or hash router.

Improvements and fixes

• Added more premade date range intervals (e.g., last 3 days, last 365 days, last 3 years).
• You can now dynamically prevent tracking the current session by returning false when overwriting the WPLY.onTrackingStarted callback.
• Updater: Check some files for write permissions before initiating the updater.
• UI: Simplify the stats layout if only the “All” segment is active.
• UI: Increase the font size (+1px) of segment names for better readability.
• UI: Improved sidebar spacing and alignment.
• UI: Improved responsive breakpoints (mobile layout).
• Clicking on a country icon now adds it to the current segment.
• Clicking on a page in Top pages now adds it to the current segment.
• Improve stats screen styling for better readability.
• Improve segment menu styling.
• Update internal JS packages
• Improve segment header layout and transition for different screen sizes.
• Improved tooltips consistency for elements that can be used as segment filters (e.g., country icon, referral chip, user IP, etc.)
• Improve header date selector positioning (show date before segments).
• Dashboard styling improvements (small UI fixes and dark mode color changes).
• Preserve equivalent segment colors for all segments when toggling dark/light mode.
• Full URL path is now displayed when hovering a page name in the visitors list.
• Migrated the visitors table to MaterialReactTable. This introduces new features like column hiding, performance improvements, UI improvements, and more.
• Implemented system to enable support renewal without having to manually contact support.
• Created a dashboard to manage and see detailed information about your WPLytic license (will be soon live).
• The licensing system has been revamped to be more robust.
• Added a way to expand the list of visited pages in the visitors list.
• Show full date, including the date of the week, when hovering Events chips and dates in the Visitors list.
• Many performance improvements
• Many bug fixes

Dashboard performance improvements, ability to expand pages visited list and bug fixes.

New

• Added a way to expand the list of visited pages in the visitors list.

Improvements

• Considerably improved multiple-domains overview loading performance.

Bug Fixes

• Fixed number of visited pages count being incorrect in the visitors list when many pages (10+) were visited in a single session.
• Fix percentages display overlapping bar in top pages/countries charts.

A big (mostly invisible for now) code upgrade to React v18 and Material UI v5.

Updating to the latest versions of React and MUI not only makes the platform more future-proof, but it also improves the performance and usability of the platform.

New

• Added pt-BR language (thanks to Rodrigo for submitting it).

Improvements

• Updated interface to MUI V5.
• Updated internal React to v18 and TypeScript to the latest versions.
• Replaced DateRangePicker to the PRO one from MUIX.
• Reduced total dashboard app size (by upgrading the ParcelJS bundler to the latest version).
• Various small UI fixes and improvements. The UI will be improved even further in v5 (Note: some small UI inconsistencies might still be noticed from the current transition to the new UI framework version).
• Better date range picker intervals.
• Upgrade internal build package (ParcelJS) to latest version.
• Improved domain selector logic/performance.
• Updated Country and City GeoIP databases for more accurate geolocation.
• Use wp-load.php instead of wp-config.php for database connection, as some managed hosting providers don’t provide proper wp-config.php files.

Improved admin privacy within the dashboard by either eliminating 3rd party requests or adding the option to disable them.

New

• Settings->Privacy – Disable domain favicon loading – Option to disable loading of domains favicons from icons.duckduckgo.com.
• Settings->Privacy – Disable new version check – Option to stop the request made on dashboard load to the WPLytic license server that checks whether a new version is available or not.

Improvements

• Replaced dashboard Inter Google Font with local font files.
• Replaced dashboard Material Icons Google Font with local font file.