DOCUMENTATION

Documentation
Browse Docs

Troubleshooting

Troubleshooting

No views or sessions are recorded

  • Test as a logged-out visitor or in an incognito window. Administrators are ignored.
  • Confirm the page post type is enabled in Settings.
  • Confirm your IP is not listed in Excluded IPs.
  • Keep the page visible for at least the active-time gate. Default is 900 ms.
  • Check that JavaScript is not blocked by optimization, consent, or security tooling.

Clicks are missing from heatmaps

  • Confirm wpmc_bh_enabled is on or unset.
  • Use ?wpmc_bh=1 for a quick enable test.
  • Check browser DevTools for WPMC_BH and for requests to /wp-json/wpmc-bh/v1/ingest or admin-ajax.php?action=wpmc_bh_ingest.
  • Mobile tracking may ignore ordinary non-navigation, non-CTA clicks to reduce noisy mobile heatmaps.
  • Make sure the selected device bucket in the admin UI matches the recorded device bucket.

Page appears in Statistics but not in the Heatmap Page List

  • Change the date range. The list defaults to the last 90 days.
  • Review Page Type, Taxonomy, Term, and Search filters.
  • Confirm the post type is enabled in Settings. The list filters available page types based on enabled types.
  • Try opening the page details from a known URL if URL variants differ by scheme, www, trailing slash, or query parameters.

Statistics charts are empty

  • Confirm the date range includes stored records.
  • Check whether wpmc_views has rows with non-empty timestamp values.
  • Confirm Chart.js and plugin chart scripts are not blocked by another admin plugin.

BH Heatmap menu location looks unexpected

The standalone BH Heatmap submenu is registered by heatclick-BH/admin-page.php. It tries to use the parent slug from WPMC_MAIN_MENU_SLUG, which is currently defined as wpmc_repo. If that parent is not registered, WordPress falls back to options-general.php. The main working heatmap workflow is still available from the Heatmap Page List and Details screens.

Table sizes do not shrink after deletion

MySQL/InnoDB may keep allocated disk space even after rows are deleted. Use the Data Cleaning page’s Optimize action and allow time for the server to report updated sizes.

Remote integration returns 403

  • Confirm the WPMissionControl API key is available automatically or saved as a manual fallback.
  • Send the token as Bearer authorization or one of the supported WPMC token headers.
  • Use an administrator session to test the endpoint directly from the same WordPress site.
  • Use the Settings page integration status to confirm the masked key and source.