Troubleshooting
Diagnose common Framework, SEO Suite and Tracking Suite problems without random changes.
Isolate one problem at a time, use HuntBee logs/Diagnostics, then test with a simple repeatable example.
General troubleshooting flow
Tracking: no events appear
- Confirm Tracking Status is enabled on Overview for the selected store.
- Turn on HuntBee Debug Logging temporarily.
- Check Diagnostics → Event Log for Captured/Prepared entries.
- Confirm the provider itself is enabled and correctly configured.
- If using External CMP mode, confirm a consent update is actually detected.
Tracking: browser event is Captured/Prepared but provider shows nothing
Prepared proves HuntBee created the browser payload, not that the provider received or accepted it. Check the browser console/network, tag/container configuration, provider test/debug tools and consent state.
Tracking: server event stays queued
Check Diagnostics → Schedule. Server-side delivery needs the Tracking scheduler. Confirm the Cron URL is being called and the Server Event Delivery job is enabled.
Tracking: theme/cart event is missing
First test with the default OpenCart flow. Some themes use different AJAX/cart rendering. Enable Observe non-jQuery AJAX only when your theme genuinely needs it. Journal3 and other advanced themes can require compatibility testing.
Tracking: GA4 refund not sent
Open Order Attribution and check whether the original GA client ID was captured for that order. The HuntBee refund can still be recorded when GA4 cannot receive it.
SEO common checks
For AI Content verify Framework AI connection and Cron; for IndexNow verify key + queue + Cron; for WebP test OpenCart's standard resize pipeline; for SEO URLs avoid repeated regeneration; for indexing changes allow external search engines time to recrawl.
Information to include in a support ticket
- OpenCart version
- HuntBee Framework version
- Suite name and version
- Affected component
- Exact steps to reproduce
- Expected result vs actual result
- Screenshot where useful
- Relevant HuntBee/OpenCart log excerpt with secrets removed
- Theme name and suspected third-party extension if applicable