Documentation

Insyta Pro — Docs

Installation, setup & all features explained step by step.

Installation

Insyta Pro is installed as a standard WordPress plugin. You need WordPress 5.8+ and PHP 7.4+.

Install Plugin

1
Download ZIP file

Log in at My Account and download the latest insyta-pro.zip.

2
Upload to WordPress

Go to WordPress Admin → Plugins → Add New → Upload Plugin. Select the ZIP file and click „Install Now".

3
Activate Plugin

Click „Activate Plugin". Insyta Pro will appear in the left menu under Insyta Pro.

4
Activate License

Go to Insyta Pro → License and enter your license key (from the confirmation email).

Update tip: To update: deactivate the old plugin, upload the new one and activate — all data is preserved. Never delete the plugin and its database tables.

Activate License

1
Copy license key

Find your key in the confirmation email (format: INSYTA-XXXX-XXXX-XXXX) or at My Account → Licenses.

2
Enter in plugin

Open Insyta Pro → Settings → License, paste the key and click Activate.

3
Check status

After successful activation the dashboard shows ✓ Active and your plan (Starter / Pro / Agency).

License on multiple sites: Pro = up to 3 sites, Agency = unlimited. Each new site requires separate license activation.

Setup Wizard

The Setup Wizard appears automatically on first open after activation and configures your dashboard in 2 minutes.

Step 1 — Choose profile

Profile Activated features
✍️ Blog / ContentClick tracking, heatmap, scroll, traffic analytics, UTM, live visitors
🛒 Online-Shop+ Rage clicks, form analytics, conversion goals, session recordings
🏢 AgenturAll features activated
💻 SaaS / App+ Session journey, A/B testing, rage clicks, dead clicks, forms
🎛️ IndividuellYou select each toggle manually

Step 2 — Adjust features

In step 2 all features are shown with descriptions. Recommended ones are pre-selected, optional ones hidden. Each toggle is individually switchable. After saving, the configured dashboard opens.

Restart Wizard

Under Settings → Restart Setup Wizard the wizard can be reopened at any time. Existing tracking data is preserved.

Customize Dashboard

Move panels

The dashboard has 5 moveable sections: KPIs, 30-day chart, click log & panels, charts view and table view.

1
Activate arrange mode

Click the ⠿ Arrange button at the bottom of the navigation.

2
Use drag handles

Drag handles appear on each panel.

3
Change order

Drag panels to your preferred order.

4
Exit mode

Click ⠿ Arrange again to exit. The order is automatically saved.

Resize Panels

In edit mode, a % button appears on each panel. Click it to cycle widths:

Desktop25% → 50% → 75% → 100% (4-column grid)
Mobile50% ↔ 100% (2-column grid)
Tip: Width is automatically saved and applies per feature tab.

Reorder Navigation

You can also reorder the sidebar/tab bar. Activate edit mode and drag menu items to your preferred position.

Tip: Long-press (600ms) on a panel or menu item to activate edit mode directly.

Reset view

Under Settings → Reset views all panel positions and nav orders are reset to default. localStorage entries and database options are cleared, the page reloads.

Settings

Setting Description
insyta_p_selectors CSS selectors of elements to track (comma-separated). Default: button, input[type="submit"], .insyta-track, [data-insyta]
Dark Mode Switches the plugin dashboard between dark and light. Independent from the frontend.
Language DE / EN / Auto (follows WordPress language setting).
Delete data after Automatically delete click data after X days (0 = never delete).
Rage Click Enable/disable + configure click count and time window.
Scroll Milestones Percentage values for scroll tracking (default: 25,50,75,90,100).

Click Tracking

Insyta Pro automatically tracks all clicks on elements matching your selectors — from the moment of plugin activation, without code changes.

Manual Marking with CSS Class

Add .insyta-track to any element:

<button class="my-btn insyta-track">Buy now</button>

Custom Label via data Attribute

Use [data-insyta="label"] for a custom dashboard label:

<button data-insyta="buy-button">Buy now</button>
Page Builders: Elementor, Divi and Gutenberg buttons are detected automatically. If not: In Elementor under „Advanced → CSS Classes" add insyta-track.

Element Scanner

The scanner automatically searches a page for clickable elements and shows which ones are already tracked.

1
Enter URL and scan

Insyta Pro → Scanner → Enter URL → Click „Scan page".

2
Assign label

Enter a readable name in the Label field (e.g. „Buy Button"). This name replaces the technical button ID in the dashboard.

3
Assign color

Click the color dot to choose a color — making the button instantly identifiable in dashboard charts.

4
Add to selectors

Click „+ Track" to automatically add the button selector to active selectors.

Selectors

Selectors are CSS expressions that determine which elements are tracked. Multiple selectors are separated by commas.

ExampleDescription
buttonAll <button> elements
#buy-btnElement with ID "buy-btn"
.cta-buttonAll elements with class "cta-button"
input[type="submit"]All submit buttons
a.btnLinks with class "btn"
[data-insyta]All elements with data-insyta attribute
.insyta-trackManually marked elements

Heatmap

The heatmap shows click coordinates as a colored canvas overlay directly on the real page. Everything runs locally — no external service.

Open heatmap

In the plugin dashboard under Heatmap → select page → click Show Heatmap. The page opens in a new tab with the overlay.

BlueFew clicks
GreenMedium click density
Yellow/OrangeMany clicks
RedHotspot — maximum click density

Scroll Map

The scroll map shows as a colored overlay on the real page how far visitors scroll. Access via URL parameter:

https://insyta.io/deine-seite/?insyta_p_sm=1

Green = many visitors saw this area · Red = only few scroll this far.

Session Recordings

Records mouse movements, clicks and scrolls. In the dashboard under Sessions you can play back each recording.

ReplayClick a session to start the recording. Use the timeline scrubber to fast-forward or rewind.
Normal clicksGreen ripple effect in replay
Rage ClicksRed burst effect in replay
DurationSession duration, page count, click count

Live-Besucher & Realtime Dashboard

The Realtime Dashboard shows all visitors active in the last 5 minutes — from the first pageload, not just after the first click. An animated counter shows the number of active visitors in real-time.

💡 Tip: Live tracking sends a heartbeat every 10 seconds. You can disable it under Settings → Live Visitors to reduce AJAX requests.

Session-Journey

Session Journey visualizes the complete visitor path: which pages were visited in which order, dwell time per page, and which buttons were clicked. Available under Analytics → Journey.

💡 Tip: Browser, OS and language are automatically captured since v3.2.0. Older entries still have these fields empty.

UTM Attribution

Every click is automatically linked to the UTM parameters of the page view. Cookie-based tracking over 24 hours — even if the user clicks only on page 2.

ParameterExample
utm_sourcegoogle, newsletter, facebook
utm_mediumcpc, email, organic
utm_campaignblack-friday-2025, launch
utm_termwordpress analytics plugin
utm_contentbanner-a, btn-red

UTM Campaign URL Builder

The built-in UTM Campaign URL Builder creates ready-to-use tracking URLs directly inside the plugin. Choose source, medium, campaign, term and content — the URL is generated live and can be copied with one click.

How it works

1
Enter target URL

Enter the URL of the page your campaign should link to (e.g. https://example.com/landing).

2
Fill in UTM parameters

Fill in the desired fields: utm_source (required), utm_medium, utm_campaign, utm_term and utm_content.

3
Copy URL

The finished URL is shown live below the fields. Click "Copy URL" to copy it to your clipboard.

Tip: All URLs created via the builder are automatically tracked by UTM Attribution in Insyta Pro — no additional setup required.

Rage Clicks

A rage click is detected when the same element is clicked multiple times within a configurable time window.

Default: 3 clicks within 2 seconds. Configurable under Insyta Pro → Settings.

Common causes: Button not responding / Page loads slowly / Link is broken / Element looks clickable but isn't.

Dead Click Detection

Dead clicks are clicks on elements that are not interactive — no link, no button, no JavaScript handler. Tracking runs automatically, no setup needed.

In the dashboard under Dead Clicks you see a table with element tag, text, CSS path and the page where the element was found — with a direct link (↗) to the page.

Form Analytics

Automatic tracking of all HTML forms without code changes. Insyta Pro detects forms on every page and measures:

Form startsWhich field was clicked first
Field dwell timeHow long the user spent in each field (ms)
Field abandonmentField left without input
Submit ratePercentage of starts that led to a submit
Optimization: The field with the most drop-offs is the most important fix candidate — often making it optional or enabling autocomplete is enough.

Traffic Analytics

Classic website statistics directly in your WordPress DB — no Google Analytics needed. Insyta Pro stores every pageview in the journey table and calculates all metrics locally.

VisitorsUnique sessions — not pageviews
Bounce RateSessions with 1 pageview / all sessions × 100
Avg DurationAvg sum of time_on_page values per session
Traffic SourcesDirect / Organic / Social / Email / Referral
Top PagesSorted by pageviews, with avg time per page
Devices / Browser / OSFrom v3.2.0 — older entries have these fields empty
Tipp / Tip: Bounce rate is color-coded — green below 50%, yellow up to 70%, red above. Entry pages (green) show where visitors arrive, exit pages (red) where they leave.

Conversion Goals

Define unlimited conversion goals based on CSS selectors. Each goal shows total hits, conversion rate and trend.

Create goal

1
Insyta Pro → Goals → New Goal

Enter a name (e.g. „Newsletter signup") and the CSS selector of the target element.

2
Ensure element is tracked

The selector must also be in the active selectors, or the element must have .insyta-track.

A/B Tests

Compare two button variants with real click data. Insyta Pro automatically calculates the statistical winner (chi-squared test, 95% confidence).

Important: Both variants must exist simultaneously on the page with separate CSS selectors. Insyta Pro tracks clicks separately — you control the display of variants yourself (e.g. via A/B testing plugin or conditional visibility).

Email Reports

Automatic reports by email — daily, weekly or monthly. Configure under Insyta Pro → Email Reports.

OptionDescription
RecipientsAny number of email addresses (comma-separated)
Intervaltäglich / wöchentlich / monatlich
SectionsChoose which data to include: Top Buttons, Rage Clicks, Scroll, UTM, Goals

Configure sections

9 sections can be toggled individually — only selected ones appear in the report:

Section Default
📊 Click overview
📈 Traffic Analytics
🔥 Rage clicks
👻 Dead clicks
📜 Scroll depth
📋 Form Analytics
🏆 Conversion goals
🔢 Top buttons
🗺️ Session-Journey

Smart Alerts

Proactive anomaly detection — get notified automatically via email or Slack when unusual patterns occur. Configure under Insyta Pro → Smart Alerts.

Alert Types

Alert Type Description Default Threshold
🔴 Rage Click SpikeRage clicks above X× average
📉 Traffic DropVisitors below X% of average50%
👻 New Dead ClicksPreviously unknown dead click elements
⚠️ Conversion DropGoal hits below X% of average50%
📋 Form AbandonmentAbandonment rate above X× average

Setup

1
Enable alerts

Turn on master toggle and enter recipient email.

2
Choose interval

Hourly or every 6 hours. Cooldown prevents duplicate alerts.

3
Configure alert types

Toggle individual types on/off and adjust thresholds.

4
Slack (optional)

Enter Slack webhook URL for parallel Slack notifications.

Baselines: Automatically calculated from the last 7 days. The first check after activation builds the baselines.

Multi-Site Dashboard

Agency Feature: Available with Agency license only.

Connect any number of WordPress sites to your main site. All remote sites appear in a central overview.

1
Copy remote token

Insyta Pro → Sites → Copy "Site Token" (generated on the main site).

2
Paste on remote site

On the remote site: Insyta Pro → Settings → Multi-Site → Paste token and enter main site URL.

3
Test connection

Click „Test Connection" — if ✓ green appears, everything is correct. The remote site now sends tracking data to the main site.

Multisite Dashboard Switcher

The Dashboard Switcher lets you switch between connected sites directly inside the plugin dashboard — without leaving the page. Select a remote site from the dropdown and see its data instantly.

Requirements

Usage

A dropdown appears in the plugin header showing all connected sites. Select a site — all tabs (Dashboard, Sessions, Heatmap, etc.) immediately show the selected site's data. The switcher remembers the last selection for the current session.

Note: The Sites tab remains visible only on the main site. On remote sites, the Sites tab is hidden.

Remote Token

The remote token is a unique security key that authenticates the connection between the main site and remote sites. Found under Insyta Pro → Settings → Multi-Site.

Tip: Never share the token publicly. If compromised, a new one can be generated under Settings.

DSGVO / GDPR

Insyta Pro is designed to be GDPR-compliant:

  • No third parties — all data is stored exclusively in your own WordPress database
  • No IP storage — IP addresses are not permanently stored
  • Session IDs are stored as anonymized hash
  • No cross-page tracking without consent (UTM cookie is optional)
  • Data deletion possible at any time (Insyta Pro → Settings → Delete data)
Privacy Policy: Recommendation: Mention Insyta Pro in your privacy policy (purpose: analysis of user behavior for website optimization, legal basis: Art. 6(1)(f) GDPR).

Tracking Exclusions

Under Insyta Pro → Settings → Exclusions you can define who and what is not tracked.

Exclude adminsAll logged-in WordPress admins are not tracked.
Exclude pagesEnter URL or URL part (e.g. /thank-you/, /admin/).

Delete Data

Under Insyta Pro → Settings → Delete Data you can selectively delete individual areas or all data:

  • Click log / Scroll data / Heatmap coordinates / Session recordings
  • Journey data / Link tracking / UTM attribution / Goals / Rage clicks
Warning: Deleted data cannot be restored. Consider creating a CSV export before bulk deletion.

GA4 / GTM Integration

Insyta Pro can send all click events in parallel to Google Analytics 4 and Google Tag Manager.

Enable GA4

1
Insyta Pro → Settings → Enable GA4

Enable toggle and enter GA4 Measurement ID (format: G-XXXXXXXXXX).

Events are sent as insyta_click with the following parameters:

event: insyta_click
button_id · button_text · page_url · device · utm_source · utm_medium · utm_campaign

Public Replay Sharing

Session recordings can be shared via a public link — without the recipient needing access to the WordPress dashboard.

How it works

1
Select session

Go to Insyta Pro → Sessions and find the desired session.

2
Click share button

Click the Share button next to the replay button. A public link is generated and copied to your clipboard.

3
Share link

The link can be sent to colleagues, clients or stakeholders. The replay view shows mouse movements, clicks and scrolls — without sensitive dashboard data.

Security: Public replay links use randomly generated filenames (randomized with random_bytes) and contain no login data. Recording files are protected from directory listing via .htaccess (Apache) and index.html (Nginx).

WordPress Dashboard Widget

Insyta Pro displays a KPI widget on the WordPress dashboard (WordPress Admin → Dashboard). This lets you see key metrics without opening the Insyta Pro area.

Displayed KPIsClicks today, sessions today, rage clicks, top button, active visitors
Automatically activeThe widget appears automatically after plugin activation. It can be moved or hidden like any WP widget.

IP Blocklist

Under Settings → IP Blocklist you can exclude specific IP addresses or ranges from tracking.

Supported formats

Single IP192.168.1.100
CIDR192.168.1.0/24
Wildcard192.168.*.*
IPv6::1
Tip: Enter your office network IPs to exclude internal visits from tracking.

Session Timeout

Session timeout defines how many minutes of inactivity trigger a new session. Default: 30 minutes.

Configurable under Insyta Pro → Settings → Session Timeout. Lower values (e.g. 15 min) generate more sessions for short browsing behavior. Higher values (e.g. 60 min) make sense for content-heavy pages where users read for longer.

A/B Test Split Mode

The A/B test tracker compares two button variants with real click data. The statistical winner is automatically determined using a chi-squared test with 95% confidence.

Create test

1
Define variants

Under Insyta Pro → A/B Tests select two CSS selectors or button IDs as variant A and B.

2
Start test

Activate the test. From now on, clicks on both variants are counted separately.

3
Evaluate results

Once enough data is available, Insyta Pro displays the statistical winner with confidence value.

FAQ

Are my own clicks tracked?

No, if you have enabled the „Exclude admins" option. Logged-in WordPress admins are not tracked.

How much data does Insyta Pro store?

Each click = 1 database row (~200 bytes). At 10,000 clicks/month = ~2 MB/month. Use the auto-delete function (e.g. after 90 days) to control database size.

Does Insyta Pro work with caching plugins?

Yes. Insyta Pro uses asynchronous AJAX calls for tracking — these are not cached. Static pages can be cached normally.

My license key doesn't work.

Check: (1) No spaces before/after the key. (2) The website URL matches the one used during activation. (3) The license has not expired. If problems persist: Contact support.

Where do I find my license after purchase?

In the confirmation email and at My Account → Licenses.

SUPPORT

Still have questions?

Our support team usually responds within 24 hours.

Contact Support FAQ