Changelog

Improvements:

• Agency: Cron jobs now work with multi-db (e.g. ust_del_heatmap_60_days.sh runs the MySQL deletion query on both the main database and all other domain databases)

• Agency: Domain names are clickable in Settigns → MultiDB → Servers usage list (it links to domain's stats).

• Logging: Improve logs for cron jobs at /server/cron/log.txt

New:

• Domain sorting: You can now sort domains based on name, visitors in last 24h, or online visitors.

  
• Domain filtering: You can now filter the list of domains shown based on the domain name.

• Domains auto-refresh interval: You can now change the refresh interval for the domains list, or disable auto-refreshing.

Improvements:

• UI: Update “Track new domain” button style and position.

Bug fixes:

• Fix for Error Tracking setting sometimes being always on.

• Fix more i18n localization plurals.

Improvements:

• Ask AI: Add support for GPT 4.1, GPT 4.1-mini and GPT o4-mini

• Ask AI: Change OpenAI pricing link to a more detailed list of models.

Bug fixes:

• Fix updating from an older version where Error Tracking didn’t exist yet.

• Fix Renew License link not working in the Trial version.

New:

• Error Tracking: You can now track and view JavaScript errors for each user session.

  

Improvements:

• Performance: Improve loading performance when going to the visitors screen for a specific domain from the domains screen.

• 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.

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).

New:

• Heatmap Wildcard Filter: You now aggregate data from multiple pages into a single heatmap.

  

Improvements:

• 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: Improved heatmap menu responsive layout.

• UI: Improved Goal blocks design.

• Dev: Updated all JS packages.

New:

• Custom Layouts (BETA): Added the ability to resize and re-order the widgets/charts in the Stats screen. You can drag cards by their title. This paves the future for new features like custom dashboards and Ask AI widgets.

Improvements:

• 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: Visitors list - Improve and move “Watch” button to avoid having to scroll all the way to the right to be able to play the recording.

• 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.

Bug fixes:

• Fix playback for default recording mode when recording contains multi-line masked text.

• Fix updater is_writable check, which might incorrectly say file permissions are wrong when trying to update UXWizz.

• Fix some stats loading bar display issues.

• Fix link to OpenAI API pricing page (they changed it).

• Fix some issues with the French locale.

New:

• Add seek functionality for full recording session playback.

Improvements:

• UI: Improved record playback and playback UI (display time and smoother progress bar).

• Tracking: Updated GeoIP databases to January 2025 versions from db-ip.com. Note: you must download/update the city-level GeoIP database from Settings → Tracking:

  

Bug fixes:

• UI: Fix caching issue when going back to visitors list after watching a recording would select the wrong domain.

Improvements:

• Updated full session recorder (RRWeb V1 → V2 Alpha).

• Improved session live playback mode (for both recording modes).

Improvements:

• 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 packages to latest versions (including React 18 → 19)

Bug fixes:

• Update the integrity check URL to use GitHub pages instead of GitHub raw.

Bug fixes:

• Fix error being shown in the console when website is accessed by a bot (e.g. Google bot).

New:

• Ask AI Charts: You can ask the AI to generate charts and also download them.

Improvements:

• If only one domain is shown, make the domain card full-width.

• Update internal JS packages to latest versions.

New:

• Device type filter: You can now filter a segment on “Desktop” or “Mobile” devices.

• Japanese locale: To report any issues or suggest a new language, use this repo: https://github.com/UXWizz/translations

Improvements:

• Translations: Add some missing translations and update a few wrong ones.

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.

• Self-host: Improve database backup script robustness, performance and error logs.

Bug fixes:

• 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:

• Docs: Added a server migration guide here.

• Self-host: Added cron example cron/ust_backup_db.sh that creates a backup of the current database. You can also use this for on-demand backups. Note: For agencies, this currently only backs up the main database.

• 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:

• Agency: Fix a potential issue with multiDB updating. Make sure you back up multidb-list.php before updating.

• 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:

• 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.

• Added example cron/ust_del_zero_sec_rec.sh that deletes all recordings with 0-second

Bug fixes:

• Ask AI: Fix execution query output when selecting data from database that is in a binary format.

New:

• Agency: Custom Pages - You can now add buttons to the sidebar that, when clicked, displays the given URL in an iframe within the dashboard. This allows to embed any type of external or local content within the dashboard.

• UST.trackNewPage() - New JS API function that triggers a new pageview. Useful for tracking SPA applications. Read more about UST.trackNewPage() in the docs.

• 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.

Improvements:

• 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.

• Default recorder - fix ust-rec-ignore and ust-rec-block still recording <select> elements when using the

• Default recorder - ust-rec-mask now will also mask select elements. This will actually behave the same as ust-rec-ignore and ust-rec-block when using the default recoder, as masking the selected value will stop it from correctly playing back.

Improvements:

• Migrate from Moment.js to Day.js (modern, efficient and better maintained).

• Always display full IP in visitors list (if not hashed or censored), instead of only the last 6 characters.

• Better handle the downloading of GeoIP databases. Make sure tracking doesn’t break if the GeoIP database is corrupt.

• Update GeoIP databases to August 2024 versions.

• Add support for the new OpenAI project API keys.

• Update JavaScript packages to latest versions.

Bug fixes:

• Fixed censorIP sometimes still displaying IP in tooltip.

Other:

• Update the feedback/bug report link to: https://feedback.uxwizz.com

Improvements:

• 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.

New:

• Multi-domain filtering: The segments header is now also displayed in the main domains page.

• You can now dynamically prevent tracking the current session by returning false when overwriting the UST.onTrackingStarted callback.

Improvements:

• Updater: Check some files for write permissions before initiating the updater. This reduces instances when the updater would silently fail.

• UI: Simplify the stats layout if only the “All” segment is active (hide segment name and segment color).

• UI: Redesign Goals block styling to make them more skimmable.

• UI: Improve Goals responsive layout for smaller screens.

• UI: Increase the font size (+1px) of segment names for better readability.

• UI: Improved sidebar spacing and alignment.

• UI: Improved responsive breakpoints (mobile layout).

Bug fixes:

• Fix (again) trial ending sooner than intended.

New:

• Added the ability to upgrade to a different license type (e.g. Company → Agency).

Improvements:

• Agency: Implement some workarounds to allow enabling multidb for an existing instance that already had tracked domains.

• Preserve equivalent segment colors for all segments when toggling dark/light mode.

Bug fixes:

• Agency: Fix total database size usage calculation if multiple domains use the same database.

• Improve separator used in GROUP_CONCAT pages list MySQL query.

• Fix dashboard crashing if toggling dark mode when more than 7 segments are enabled (because only 7 segment colors are available).

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. Learn more about goals in the docs.

  

Improvements:

• 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 to their latest minor versions.

• 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.)

Bug fixes:

• Fix a bug where sometimes adding a segment filter would add it to the wrong segment.

• Fix segment header layout when many segments are saved.

Improvements:

• Improve header date selector positioning (show date before segments).

• Improve session recordings:

  • Reduce sessionStorage data usage used for recording caching.

  • Fix some recordings missing when visit duration was long.

  • Reduce session recordings network traffic by ~50%.

  • Improve client-side recording performance.

Bug fixes:

• Fix reset icon positioning in header date selector.

• Fix domain icon alignment in sidebar domain selector.

• Fix trial ending sooner than intended.

Improvements:

• Trial version is now 14 days (instead of seven).

• Update some internal node packages minor versions.

Bug fixes:

• Fix JSON encoding in the AI response unnecessarily escaping slashes and Unicode characters, making the response hard to read.

• Fix PHP 8 notice if a visitor had no tags. (Thanks to Rodrigo for the fix)

• Fix selected rows in visitors list after deleting an entry.

Improvements:

• Ask AI: If the SQL query fails to execute, display the error message instead of 500 Internal Server Error.

• Ask AI: Add a warning banner stating that the returned MySQL queries could be incorrect.

Security:

• Ask AI: Add an extra check, to make sure the user has access to the domain they want to chat with the AI about.

New:

• 🥳 Ask AI: ChatGPT integration: You can ask the AI questions about your data. Learn more about Ask AI in the docs.

• Smart auto chart granularity: The granularity of charts automatically switches to a better value (e.g. if you choose to view “last 2 days”, the graph will switch to hourly, if you choose “last 3 years”, the graph will switch to monthly).

Improvements:

• Dashboard styling improvements (small UI fixes and dark mode color changes).

• Full URL path is now displayed when hovering a page name in the visitors list.

• Added more pre-made date range intervals (e.g. last 3 days, last 365 days, last 3 years)

• Migrated the visitors table to MaterialReactTable. This introduces new features like column hiding, performance improvements, UI improvements and more.

Bug fixes:

• Fix recorded visitors number in domains overview sometimes showing 0 (caching issue).

Other:

• Updated TypeScript (v5.0 → 5.4)

• Updated MUI (v5.13 → 5.15)

• Updated ChartJS (v3 → v4)

• Updated i18next (v19 → v23)

• Updated various other internal package dependencies.

• Updated Licenses and pricing

  • Updated the refund period to match the advertised one (14 days).

  • The Agency license now matches the Company license "install on up to 5 servers"

  • Improved TL;DR; format.

New:

• Implemented system to enable support renewal without having to manually contact support.

• Created a dashboard to manage and see detailed information about your UXWizz license (will be soon live).

Improvements:

• The licensing system has been revamped to be more robust.

Bug fixes:

• If your support period is expired, you will see the correct message inside the dashboard instead of “Invalid license”.

Notes:

• Until now, you might have been able to access the latest releases without having a valid support/updates period. Unfortunately, this has a major impact on the resources available for the project’s development. If you do like UXWizz and want to speed up the rate of updates, please consider renewing your support period. Each and every sale matters a lot for our small company.

New:

• 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:

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

• Show full date, including date of the week, when hovering Events chips and dates in the Visitors list.

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.

• Fix displayed Events time, when server timezone is different from your timezone.

• Fix tag removal when using multi-db.

Improvements:

• Considerably improved multiple-domains overview loading performance.

• Updated Country and City GeoIP databases for more accurate geolocation.

Bug fixes:

• Fix segment header not being displayed on the heatmaps page.

• Agency: MultiDB – Fix domain total visitors count not showing properly in the multi-domains overview screen.

Internal Development:

• Refactored the entire codebase to remove @‌material/styling and replaced it with the new MUI v5 sx prop. This made the code cleaner and allows for a quicker component development.

Improvements:

• Agency: Added UI for uploading the logo image for the dashboard (instead of having to paste the base64 image string).

Bug fixes:

• BUG: Fix dashboard crashing when no domains were added (e.g. after initial setup).

• UX: Fix currently selected domain changing to first domain in list when going back to overview.

• Minor fixes for some warnings shown in the JS console related to URL routing.

New:

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

Improvements:

• Improved domain selector logic/performance.

Bug fixes:

• Fixes when the new MultiDB feature is enabled:

  • Fix A/B tests creation

  • Fix viewing events

  • Fix record watched flag

  • Fix domain selector

  • Fix adding/removing tags through the interface

• Fix domain selector UI sometimes not working.

Improvements:

• Better date range picker intervals.

• Upgrade internal build package (ParcelJS) to latest version.

New:

• Agency: Multi database support - When first setting up the dashboard, you can choose to store the data for each domain in a separate database on the same server.

• Agency: Multi database servers support - You can now scale the database for new websites or users by adding multiple database servers. Each new domain tracked can have the data stored on any of the listed database servers. Both those changes together can drastically improve performance, security and privacy.

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).

Bug fixes:

• Fix SET_USER_MAX_DOMAINS permission not being properly checked.

Other:

• App paths switched to HashRouter: The routing in the dashboard (URLs) has been changed to HashRouter. This was done to remove the need of .htaccess redirects and improve compatibility with NGINX and other webservers that don’t support URL rewrites. Paths will now look like app**/#/visitors** instead of app**/visitors**. If you get a 404 error accessing the dashboard from your browser history or bookmarks, update the saved URL to include the hash symbol.

WordPress:

• Fixed a potential warning with undefined $UST_VERSION

• 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.

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 UXWizz 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.

New:

• Agency - max domains per user - You can now set a limit on how many domains can an individual user track.

• New user permission: CHANGE_OWN_DOMAIN_ACCESS - Level 3 users can now change their own domain access (add/remove domain) without being able to do the same for other users.

Improvements:

• UX: Clicking a domain in the users list now opens the domain settings dropdown (limit, tracking pixel info).

• Agency: Removed three external links to the UXWizz documentation website in order to better respect the white-label feature. In the future, more documentation will be included locally instead of linking to docs.uxwizz.com.

Bug fixes:

• Don't show Add tracker info if domain add failed

New:

• New playback controls: session playback can now be paused and sped up by 2x, 4x or 8x.

Improvements:

• The default link in the (optional) consent pop-up now leads to a local copy of the privacy-policy instead of the UXWizz documentation.

Bug fixes:

• Fix local links in Agency sidebar being relative to server root instead of UXWizz server root.

• Fix custom logo in Agency not being used in some locations.

• Fix login redirect still not working on some servers where $_SERVER['DOCUMENT_ROOT'] doesn't return the correct path.

Improvements:

• The updates settings page and new version notification are now hidden to users that don't have the UPDATE_PLATFORM permission.

Bug fixes:

• Fix full-page record playback not working when the recorded page contained the text Error:.

• Fix a React warning logged during playback.

• Fix redirect after login being wrong in some server environments.

New:

• Agency version - Custom links in sidebar: You can now add custom links/text in sidebar. Use this to link to your website, promote other services, or link to your own customer's portal.

Bug fixes:

• Fixed error messages being displayed in the dashboard when the login session expired. Now you are properly redirected to the login page (without having to refresh).

• Fixed dashboard long error message when using a license for a different variant than the one installed.

• Agency version - Suppress error message when saving settings without adding a custom logo.

Other:

• User permissions have been updated. To better separate user roles, now only level 5 users (root) can change the dashboard itself (update, set license key, change tracking settings). Level 4 users (admins) can now also manage user accounts (create/delete users, change domain access). You can not change your own user level. You can not set to others a user level higher than your own.

• The current dashboard version is now also stored in the ust_meta table, with the key VERSION. This is useful for checking using MySQL which version is currently installed.