ClickClueGet ClickClue Free
Menu
← All guides

SET UP

Record your first WordPress visit with ClickClue.

Install ClickClue, record a sample visit and check what your visitors would share.

Watch the video overview

Free + Pro7 min readFree and Pro 1.2.7 guidance

Free + Pro guide (1.2.7 PDF)

In this guide 9 sections

Before you start

#

Use WordPress 6.6 or newer and PHP 8.1 or newer. Start on a staging copy with a database backup. ClickClue stores recording events in your WordPress database and eligible public design snapshots on your server; it does not need a cloud recording account.

  • Activate the plugin separately on each site. Network activation is not supported.
  • Use transactional InnoDB tables on MySQL/MariaDB. Allow space beyond the replay payload limit for database indexes and backups.
  • Use synthetic details and sample form submissions for your first test.

Install the free plugin

#
  1. Install ClickClue Free 1.2.7 from the official WordPress.org directory, or search for ClickClue in Plugins → Add New Plugin. Existing sites can use the update offered on their Plugins screen.
  2. Choose Install Now, then Activate. If you downloaded the directory ZIP, use Plugins → Add New Plugin → Upload Plugin instead. Follow the upgrade guide if your existing installation uses an earlier plugin folder.
  3. Open ClickClue. A new installation starts setup with recording paused and none of the three modes selected. Seven-day retention and readable ordinary page text are the defaults; typed values and private regions stay protected. Setup asks you to choose a storage policy and where visitors can stop recording before you enable it.

Record an eligible visit

#

In 1.2.6, optional public font-style loading no longer holds up recording startup. Recorder loading overlaps server authorization after sampling permits the visit. Capture still waits for the selected recording basis, eligible page and server approval; check an acknowledged upload before calling the test successful.

After Save & enable recording, reloading the same administration tab returns to Test a visit while the saved setup still matches. Choose Finish setup when you are done. This reminder is stored in that tab; it is not proof that a test recording arrived.

  1. Choose Ask with ClickClue’s banner, Use my existing consent banner, or Record without asking first. The help button beside each choice explains it without selecting it. Opening setup, choosing a mode or moving to Review does not enable recording.
  2. For ClickClue’s banner, publish your website-specific privacy policy and select it in WordPress Settings → Privacy. Use the review-step link and Check privacy notice again after returning. Setup cannot finish in this mode while the published policy is missing. For an existing banner, connect the consent APIs in this guide before relying on recordings.
  3. Choose where visitors can stop and delete the current recording: the floating Replay privacy button, or your own footer/menu or connected control. The floating button remains off unless chosen. A custom-control choice is your declaration; it does not automatically create or verify the control.
  4. Choose a storage policy explicitly: 0 for no plugin storage budget, or a positive budget your host can support. Review masking, exclusions and retention. Cart and checkout are excluded by default; their advanced inclusion requires Mask all page text. Select Save & enable recording only when ready. This saves 100% sampling until you change it.
  5. Clear page/CDN caches. Copy the test link into a signed-out private window. Administrators and other signed-in users are excluded; a normal new tab may still be signed in.
  6. Choose one public page and a question, such as whether someone can find the size guide. In banner modes, grant replay permission through the chosen connected banner. In the without-asking mode, visit directly; eligible capture follows the saved owner policy. Scroll and click using synthetic details, then leave the page open for activity to upload.
  7. Choose Check for a recording. Enabled recording is only a setting; a newly received upload is separate evidence. The latest recording may belong to another visitor. Open it and check the page, time, masking and actual actions before treating it as your test.
  8. After checking the replay, open the privacy control in your signed-out test tab. Stop the recording and wait for deletion confirmation. This removes that test recording; capture stopping alone does not confirm deletion. Test both acceptance and refusal if you use a consent banner.
  9. Lower sampling to your intended rate or pause recording after the test. Existing installations can use Settings → Test & diagnostics → Prepare test settings; this only prepares a draft until Save settings is selected.

An optional walkthrough in both editions

#

Choose Start tutorial at the top of the ClickClue dashboard. Free covers recording and review; Pro continues into grouped evidence, saved investigations, assignments and descriptive comparisons. Pause or resume whenever you like. The walkthrough never changes recording settings, grants consent or connects a service.

Progress is a checklist you mark yourself, saved in the current browser for your WordPress account and edition. It is not a verified setup result. Reset tutorial progress clears only that checklist. You can use every feature without completing it.

Add ClickClue Pro

#

Install a compatible Pro add-on alongside ClickClue Free. Update Free first, then Pro. Pro adds Clues, heatmaps, structural form insights, journeys, comparisons and optional feedback without requiring WooCommerce. Earlier checkout integrations remain documented separately. Pro 1.2.7 is available from eligible ClickClue accounts and requires Free 1.2.7 or newer. Update Free first, then Pro, without uninstalling either plugin.

Pro requires ClickClue Free and a successful first licence activation for this site. Annual bundles cover 1, 5 or 25 sites with the same Pro features. Open ClickClue → Pro licence to activate. Once unlocked, local tools keep working offline or after updates and support expire; eligible updates and support are separate.

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.

Leave an honest review, when you are ready

#

The Help page always links to the WordPress.org review page. A small invitation can also appear inside ClickClue after at least 30 days from its first successfully recorded visit tracked by version 1.1.5, and after you have reviewed ten distinct recordings across five UTC days. These bounded counters and your choice stay in this WordPress installation; they are not interest analytics sent to ClickClue.

Choose Leave an honest review, Remind me in 30 days or No thanks. No thanks permanently dismisses the invitation for your administrator account; updates preserve that choice. You can still use the Help link later. Opening the review page does not tell ClickClue whether you posted a review.

Keep your workspace useful

#

New installations open setup first. Existing installations normally keep the Recordings starting view and are not forced through setup again. An unfinished test step saved in the current tab can return until you finish it or change the setup. Status distinguishes unfinished setup, paused recording, a missing privacy notice, a full storage budget and cleanup checks. Follow the linked setting to review the cause. Recording mode and enabling changes require an explicit save.

In Free, the Pro previews switch hides or shows three optional feature previews. The choice is saved for your WordPress account on this site; existing hidden choices remain hidden after updating. Explore Pro stays available. The switch does not enable or disable recording or paid features.

Help & guides opens public Documentation or the installed guide. More Plugins lists companion tools from Plugins.shop, with useful matches first and original logos stored inside the plugin. Installed badges use local known-plugin checks for administrators who can manage plugins. Links open a new tab only when selected; no remote catalogue request, installation or marketing signup is made.

Check the visit, then choose your recording settings

#

After your first test, compare the actual clicks, scrolling and page navigation with the replay. The event list includes clicks and grouped scrolling; select an event to inspect that moment. A scroll label describes recorded movement, not a heatmap or a measure of how much content a visitor read.

The Size column and replay header include the assets used by that recording. Total storage counts shared image and font snapshots only once, so it may be less than the sum of individual sizes. Page structure and styles affect size; inspect representative pages before changing sampling, retention or your storage budget.

Saved through the last checkpoint means the announced uploads arrived; it does not guarantee that every moment of a visit was captured. Final upload unconfirmed means the visit may still be arriving or may have ended without a final receipt. Recording interrupted means capture reported a gap or announced uploads are missing. Load latest activity to check for newer saved events.

Finish with a reviewable test

#

Before deleting your synthetic test recording, check three things: it matches the page and time you tested; the relevant interaction is visible; typed values and private regions are protected. An upload confirmation alone does not establish all three.

  • Write one observation, such as “the size guide opened after the click,” and one next check. Keep personal details out of notes.
  • Test your chosen visitor privacy control and wait for deletion confirmation. Then set the sampling and retention you intend to use.

Use the guided tutorial for practice, or preview the replay demonstration before installing.