Troubleshooting

Widget not loading / showing blank

Possible causes:

• Embed code not pasted correctly (check for truncated code)
• Content Security Policy (CSP) blocking iframe (check browser console)
• Ad blocker or privacy extension blocking the widget

Solutions:

1. Re-copy the embed code and paste again
2. Check browser console (F12) for error messages
3. Temporarily disable ad blockers to test
4. If using CSP, add BookerKit domain to allowed iframes

Services not loading / "No services available"

Possible causes:

• Zenoti API credentials incorrect or expired
• No services marked as bookable online in Zenoti
• Services filtered by "show only consultations" setting

Solutions:

1. Verify Zenoti credentials in your account settings
2. Check Zenoti admin to ensure services are enabled for online booking
3. Review widget settings — disable "show only consultations" if not intended

Styling doesn't match my website

What to check:

1. Go to Widget → Settings and adjust:
   • Primary color (main brand color)
   • Button text color (contrast with primary)
   • Border radius (0-32px for button roundness)
2. Use the live preview in settings to see changes in real-time
3. Save settings and refresh your website to see updates

Analytics events not appearing in GTM/GA4

Debugging steps:

1. Open browser console (F12) and type dataLayer — verify events are appearing
2. Check that the analytics listener script is included in the embed code (automatically added)
3. Verify GTM is installed and working on your website
4. Use GTM Preview mode to see events in real-time
5. Ensure no browser extensions are blocking tracking scripts

If events appear in dataLayer but not in GA4/GTM:

• Create triggers in GTM for BookerKit event names
• Set up tags to forward events to your analytics platform
• See the Analytics Setup section for detailed instructions

Button trigger not opening / sheet not appearing

Common causes:

• JavaScript error on the page preventing script from running
• Embed code placed in wrong location (should be before </body>)
• CSS z-index conflict with other page elements

Solutions:

1. Check browser console for JavaScript errors
2. Move embed code to just before closing </body> tag
3. Try the iframe embed instead if issues persist

Mobile responsiveness issues

The widget is fully responsive and optimized for mobile devices.

iframe embed on mobile:

• Adjust iframe height for mobile if needed using CSS media queries
• Recommended: Set width: 100%; height: 600px; on mobile

Button trigger on mobile:

• Automatically goes full-width on screens under 768px
• Optimized for touch interactions
• Generally provides better mobile UX than iframe embed

SMS verification code not arriving

Troubleshooting:

1. Verify phone number is entered with correct country code
2. Check that Zenoti SMS service is configured and active
3. Ensure phone number isn't on a block list
4. Wait 60 seconds before requesting a new code
5. Try a different phone number to test