ClickClueGet ClickClue Free
Menu
← All guides

SET UP

Update ClickClue without losing your recordings.

Update ClickClue Free and Pro while keeping your recordings and configuration.

Free + Pro10 min readFree and Pro 1.2.7 guidance

Free + Pro guide (1.2.7 PDF)

In this guide 21 sections

Update to Free and Pro 1.2.7

#

Free 1.2.7 is available from WordPress.org. Pro 1.2.7 is available from eligible ClickClue accounts and requires Free 1.2.7 or newer. Back up first, update Free, then update the separate Pro add-on, without uninstalling either plugin.

Reload open administration tabs and clear page/CDN caches so the dashboard, recorder and player use matching assets. Test a fresh signed-out visit with sample details and inspect its replay, masking and stop/delete confirmation.

Whole-visit event navigation now indexes saved click, scroll and page markers before playback. Long lists are loaded in bounded sections; selecting a marker opens its saved page. Free and Pro share the same navigation behavior.

Durations display consistently in whole seconds, your notes say You, and the setup test step survives a reload in the same tab while its saved state still matches. Storage and connected-policy wording is clearer.

Newly captured form values use a fixed-length mask. Built-in private-page rules match whole path parts, and consent status events include the current state. Existing custom path rules retain their semantics. Existing exported files and backups are not rewritten; old recordings cannot gain actions or assets that were never saved.

1.2.6: capture startup and review improvements

#

Free 1.2.6 is available from WordPress.org. Pro 1.2.6 is available from eligible ClickClue accounts and requires Free 1.2.6 or newer. Back up first, update Free, then update the separate Pro add-on, without uninstalling either plugin. An ordinary upgrade preserves saved recordings, bookmarks, notes, settings and licence state.

Reload open administration tabs and clear page/CDN caches so parent, recorder and player assets match. Make a fresh signed-out test visit using synthetic details. Existing recordings cannot gain events or assets that were never saved.

Free 1.2.6 starts capture without waiting for optional public font styles and overlaps recorder loading with server authorization after sampling permits the visit. Eligible public or approved image clicks now contribute to replay and Pro observations. Validated saved fonts can fall back to data fonts under compatible host security policies.

Pro 1.2.6 keeps the last successful report visible during invalid date ranges or request errors, identifies affected date controls and explains empty page/layout selectors. Dedicated reviewer and analyst sign-ins normally open ClickClue. Named collection deletion confirms the target while retaining the underlying recordings.

1.2.5: delivery and safer review actions

#

Free 1.2.5 protects newer recording and privacy settings from older open tabs or simultaneous saves. A conflict retains the draft and offers an explicit reload. Final upload checkpoints take priority, duplicate background handoffs are avoided, and delivery labels distinguish recent activity from an unconfirmed final checkpoint.

The configured public WooCommerce placeholder can appear in saved design assets while private attachments remain protected. Recording deletion previews identify their targets. Date-filter errors appear beside the controls, and saved-filter names that become empty after markup removal are rejected.

Pro 1.2.5 waits briefly for concurrent reads while preserving exclusive mutation and licence guards, lets entitled reviewer and analyst roles reach their authorized workspace through WooCommerce’s admin restriction, and defaults collections to Private with clearer field validation. It requires Free 1.2.5 or newer. These historical changes are included in the matching 1.2.6 pair.

1.2.4: setup and recording safeguards

#

Free 1.2.4 is available from WordPress.org. Back up, update Free without uninstalling and clear page/CDN caches. Existing recordings, recording mode, masking, retention, storage choices and licence state remain. Review the current settings and record a new signed-out test visit.

Cart and checkout are now excluded by default, including configured WooCommerce pages. Deliberate inclusion requires Mask all page text. Account, order-pay and order-confirmation pages remain excluded. Test your actual checkout with sample details before relying on its coverage.

New setup asks separately for your storage policy and visitor-control placement. Existing sites keep their settings and can see a reminder to declare these choices. A custom footer/menu or connected control must work in practice: test stopping and deleting the current recording while signed out. The floating button stays off unless chosen.

Captured CSS is checked before storage and older CSS is checked when read. Background batches clean stored older CSS; backups and files already exported are not rewritten. Server-side sampling admission is enforced. Browser-reported permission and server acceptance do not prove that a human clicked a banner.

Pro 1.2.4 is available from eligible ClickClue accounts and requires Free 1.2.4 or newer. It shares the current CSS checks for replay and recording exports. Update Free first, then Pro through an eligible WordPress update or the account ZIP. An ordinary upgrade preserves existing recordings, bookmarks, notes, settings and licence state. The Free update does not itself replace the separate Pro add-on.

Do not delete and reinstall to upgrade or activate duplicate plugin folders. Existing recordings cannot gain missing events or assets. Check masking, visitor withdrawal and upload confirmation on a representative new visit after clearing caches.

1.2.3: recording selection and cleanup

#

Free 1.2.3 introduced the recording-management changes below. Use the current release and update procedure above when installing today. Existing recordings, recording mode, masking, retention, storage choices and licences remain on an ordinary upgrade.

Recordings now has selection checkboxes, bulk review actions and administrator deletion. Sort or filter by duration, inspect upload details and choose optional auto-refresh. Clean up ≤5s previews eligible short recordings before confirmation and protects bookmarks and recent uploads.

Pro 1.2.3 requires Free 1.2.3 or newer and shares its recording-management and privacy behavior. Update Free first, then install a compatible Pro package when it is available to your account. The public Free release does not itself update a private Pro installation. Check the version offered in your account before replacing the add-on.

Do not delete and reinstall to upgrade. Do not activate duplicate old and new plugin folders. Existing recordings cannot acquire missing events or design assets retroactively.

What changed in 1.2.0–1.2.2

#

1.2.0 introduced saved public images, backgrounds, fonts and safe SVG geometry, plus long recordings without the former per-visit cutoff. Design capture starts on for fresh installations and off on upgrades until you enable it. Keep your chosen masking policy; private regions retain priority.

1.2.1 corrected duration handling when browser and server clocks differ, improved delivery of large starting pages and added host-throttling recovery. A started visit is counted before its first replayable page is received. Older incomplete recordings cannot be filled with events that never arrived.

1.2.2 made the floating Replay privacy button optional and off by default. Enable it in Settings or link to #clickclue-privacy from your own footer/menu. The selected initial consent banner still works independently.

1.2.0: visual assets and long recordings

#

Back up and update Free first, then a compatible Pro release if installed, without uninstalling. Clear page/CDN caches. Pro 1.2.0 requires Free 1.2.0 or newer for long recordings, shared replays, heatmap views and recording exports.

Existing recording mode, masking, sampling, storage budget and retention settings remain. Public design asset capture starts off on upgrades; enable it in Settings after reviewing the scope. Fresh installations include it in setup. Existing recordings cannot gain assets or page text that were never saved.

Set the storage budget to 0 for no plugin budget, or choose your own budget. Retention 0 keeps new recordings until manual deletion. Increasing retention or choosing 0 does not extend an existing recording’s deadline; shortening retention can remove older recordings sooner. Hosting capacity and per-request protections still apply.

Pro recording export downloads a .clickclue.jsonl data archive in bounded sections. It is not a video or standalone HTML player. A final completion record and checksum identify a complete download; a truncated or interrupted file must not be treated as complete. Downloads and backups need separate retention and access controls.

Free 1.1.10: explicit recording-mode setup

#

This is a Free-only update; it does not include a new Pro package. Keep your compatible Pro add-on. Existing installations retain recording state, sampling, privacy settings, recordings, integration identifiers and licence state. They are not forced through first-install setup.

Existing built-in-banner use maps to Ask with ClickClue’s banner. Existing external-consent use maps to Use my existing consent banner. Record without asking first requires a deliberate owner selection and save; updating never selects it. Valid refusals and opt-outs remain respected.

Only fresh installations start with no selected mode and recording paused. The final wizard action saves the selected mode and 100% sampling explicitly. Clear page/CDN caches after updating and check a signed-out sample using the saved mode.

ClickClue Free and ClickClue Pro

#

The current installer ZIPs use the clickclue and clickclue-pro folders. Both editions keep existing recordings, settings, licence state, consent choices and integration identifiers.

If you previously installed a package under another folder name, deactivate the existing Pro and Free copies before uploading these ZIPs. Activate the new Free copy first, then Pro. Leave old copies inactive and do not delete or uninstall them to change names.

Update inside WordPress

#

From Pro 1.1.5, eligible updates appear on the normal WordPress Plugins screen. Keep Free compatible with your Pro version: update Free first, then apply an eligible Pro update when one is available. Free-only releases do not require a new Pro package. You can use WordPress’s optional automatic-update control for Pro. Back up and test your theme and integrations before updating; automatic updates depend on WordPress’s scheduled checks.

If you already use Pro 1.1.4 or earlier, download the current matching Pro ZIP from your eligible ClickClue account and replace it manually once to install the updater. Update Free to a compatible current version first. Future eligible Pro releases can then update through WordPress.

Pro checks update eligibility through the ClickClue licensing service. Download eligibility and package integrity are checked again before installation. A network or verification failure stops that update; it does not remove earned local Pro tools. Manual eligible-account ZIP replacement remains available.

A valid first licence activation unlocks this site. Once unlocked, local Pro tools keep working offline or after the update and support subscription expires. Expired subscriptions do not receive new Pro packages. Deactivate licence releases the site remotely when available; Forget local licence only clears this installation’s saved licence details. Either action locks Pro tools and pauses scheduled reviews without deleting recordings or settings. A copied site needs its own activation.

Replace the installed packages

#
  1. Back up your WordPress database and plugin files. Test on a staging copy first.
  2. Download the current ClickClue Free ZIP and, if entitled, the matching Pro ZIP from your account. Use each installable plugin ZIP separately; the WordPress.org SVN repository kit is not an installable plugin.
  3. For an installation already using the clickclue and clickclue-pro folders, upload Free first and accept WordPress’s replacement comparison, then replace Pro.
  4. When moving from older folders, deactivate existing Pro and Free first. Upload and activate Free, then Pro. Leave the old copies inactive; do not click Delete or uninstall. Never activate two copies of either edition.
  5. Clear page/asset caches. Check your saved settings and record a signed-out synthetic visit. Confirm masking, playback and the interactions you intend to review.

Updating to 0.9.0

#

Back up your site, update Free first and then matching Pro without uninstalling, and clear page/CDN caches. Keep the existing installation directory. Free0.9.0 works on its own; Pro0.9.0 requires Free0.9.0 or newer.

Existing settings, recordings, image approvals, legacy answers and saved funnels are migrated. New tables hold transport checkpoints, report membership and team/campaign records. Valid consent remains when scope is unchanged; enabled goals, campaigns and image approval changes require current positive consent. Previous refusals remain respected.

Use a signed-out test visit on your own theme and integrations to check masking, approved images, completion goals and withdrawal before relying on new reports.

Updating to 0.8.1

#

Back up your database and plugin files. Replace Free first, then matching Pro 0.8.1 if installed. Use the package for each existing plugin directory and do not uninstall to update. Clear page and asset caches, then check a signed-out sample visit.

Updating from 0.8.0 to 0.8.1 preserves valid existing replay choices, recordings and saved settings. Upgrading from a release before 0.8.0 still requires fresh positive replay consent; refusals remain respected.

This release includes local tutorial help and clearer approved-image privacy guidance. Recording stays paused or enabled according to your saved settings. On multisite, uninstall cleanup follows each site’s own saved deletion preference.

Compatibility introduced in 0.8.0

#

Version 0.8.0 introduced the approved-image option and a new replay notice. An upgrade from a release before 0.8.0 requires fresh positive replay consent, while existing refusals remain respected. Use the current matched installers and keep the existing plugin folders, recordings and settings; do not uninstall to update.

Both editions have no monthly recording quota. Free keeps replay, saved filters, bookmarks, notes and every privacy control. Pro adds analysis, visitor feedback and collaboration in the separate add-on.

Approved image capture starts off. Existing recordings do not gain images or new observations retrospectively. New optional feedback remains off until deliberately published. Existing survey settings are preserved; updating does not enroll a visitor or enable an external service.

Use fit-width or fit-window, zoom, the event timeline and fullscreen where supported. Review your actual pages with masked text and private regions before increasing recording.

Compatibility introduced in 0.6.10

#

Version 0.6.10 clarified the review workspace. Its historical update-delivery preparation is superseded by the current WordPress updater described above. Later versions remove edition-based monthly allowances and share retention and storage controls across Free and Pro.

The dashboard opens on Recordings, with Pro page analysis under Heatmaps & forms. Checkout tools and their saved data are preserved under Legacy checkout; configured legacy email and AI services are not automatically disabled.

New installations start with seven-day retention and no plugin storage budget. Upgrading preserves your chosen settings and storage budget. Review Settings → Storage & retention before increasing sampling, retention or storage.

A valid first licence activation unlocks this site. Once unlocked, local Pro tools keep working offline or after the update and support subscription expires. Expired subscriptions do not receive new Pro packages. Deactivate licence releases the site remotely when available; Forget local licence only clears this installation’s saved licence details. Either action locks Pro tools and pauses scheduled reviews without deleting recordings or settings. A copied site needs its own activation.

Compatibility introduced in 0.6.9

#

Version 0.6.9 brings the 0.6.8 privacy and reliability fixes together with recovery when you return using the browser Back button while a recording start is still pending. Use the current matched installer ZIPs, replacing Free first, then Pro if installed. Do not uninstall or rename their folders.

Clear page/CDN caches and check a signed-out sample visit. Your recordings, settings, storage budgets, bookmarks and notes remain in place. Version 0.6.8 privacy choices stay valid; older positive choices may need a fresh consent decision.

On multisite, newly saved filters are separate for each site. Old filters did not record which site they belonged to, so they remain available on the main site; recreate any filters you need on secondary sites.

Compatibility introduced in 0.6.3

#

Version 0.6.3 improved setup and consent recovery. Install the current matching packages above, replacing Free first, then Pro, and clear page/CDN caches. Existing data, folder names, consent API aliases and storage budgets remain compatible.

Recording health now flags a missing published privacy policy. The test panel refreshes after a failed start followed by refusal, and identifies origin-verification failures. Test real capture on hosted staging: a browser-based WordPress sandbox can omit the Origin header. Keep origin protection enabled.

Compatibility introduced in 0.6.2

#

The 0.6.2 release introduced the notice and consent changes below. Install the current matching Free and Pro packages, replacing Free first, then Pro. Existing recordings, roles, notes and storage budgets remain compatible. Do not uninstall or rename folders.

Publish and select your store-specific privacy policy in WordPress Settings → Privacy. The built-in prompt now needs its published link. Clear page and CDN caches after updating: older loader revisions cannot start or upload recordings under the new notice.

Older positive browser choices require fresh permission; a valid refusal remains refused. New recordings have a notice revision, server receipt and fixed retention deadline. Existing records have no invented historical consent. See the consent guide for CMP revision handling and evidence.

Compatibility introduced in 0.6.1

#

Version 0.6.1 used the same Free-first, then Pro replacement flow. Use the current matching packages above. The optional tutorial is available at the top of the dashboard after updating; it does not change capture settings, consent or connected services.

Existing 0.5.1 and 0.6.0 installations retain their recording identifiers, stored data, consent API aliases and chosen payload budget. Clear page caches after replacing the ZIPs. Tutorial checklist progress is local to the browser, account and edition; resetting it never deletes recordings.

Compatibility introduced in 0.6.0

#

Version 0.6.0 kept the same WordPress ZIP replacement flow: Free first, then Pro. Folders, database identifiers, existing replays, review notes and consent API aliases remain compatible. Follow the current replacement steps in this guide.

Storage budgets are preserved at the earlier edition’s effective ceiling. Review Settings → Storage & retention before raising them. Older recordings keep their normal replay and position grid; new measured heatmap events enable the page overlay.

Recover from an unsuccessful update

#

Pause capture if the updated site behaves unexpectedly. Keep a copy of the error and your previous package/database backup. Restore the matching plugin files from your known-good backup, then verify the database and settings on staging before resuming.

If WordPress cannot complete the update, obtain the matching eligible Pro ZIP from your account and use manual replacement. Do not uninstall to update. Check ClickClue → Pro licence if activation or update eligibility needs attention.