Website Integration Troubleshooting

Quick solutions to common website integration problems.

Widget Not Displaying#

Widget shows blank or doesn't load

• Check your studio slug in the embed code
• Verify your studio profile is active
• Try iframe method instead of script method

Script errors in browser console

• Confirm embed.js URL is loading: https://naayya.com/plugin/v1/embed.js
• Check for JavaScript conflicts with other plugins
• Try placing script just before closing </body> tag

Styling Issues#

Colors not matching your brand

• Verify hex color codes include the # symbol
• Check color codes are 6 characters (e.g., #F55E12, not #F55E)
• Use color picker to get exact hex values

Widget looks broken on mobile

• Remove forceDesktop=true parameter
• Set iframe width to 100% instead of fixed pixels
• Check your website's CSS isn't overriding widget styles

Text too small or hard to read

• Increase widget height (minimum 400px recommended)
• Set text color to contrast with background
• Check your website's CSS font-size rules

Filter Problems#

Filters not working

• Check parameter spelling: locations not location
• Verify location/teacher IDs are correct (check Admin panel)
• Use comma separation: teachers=id1,id2,id3

Pre-filters showing wrong content

• Confirm location/teacher/category IDs match your data
• Check for typos in category names (case-sensitive)
• Test with single filter first, then combine

Search not working

• Remove hideSearch=true if you want search visible
• Check search terms don't conflict with pre-filters
• Programs and Shop support search, Calendar/List don't

Platform-Specific Issues#

WordPress: Widget not saving

• Use Text/Code block, not Visual editor
• Switch to HTML mode when pasting code
• Try Custom HTML block instead of text widget

Squarespace: Widget cuts off

• Use Code Block, not Embed block
• Set fixed height in iframe tag
• Check page width settings aren't too narrow

Wix: Widget not responsive

• Use HTML Component, not iframe element
• Set width to 100% in HTML code
• Adjust container element sizing

Performance Issues#

Widget loads slowly

• Check your internet connection first
• Try iframe method (fastest loading)
• Reduce widget height if loading many events

Widget causes page lag

• Move script tag to bottom of page
• Use async attribute on script tags
• Consider loading widget on user interaction

Common Parameter Errors#

URL parameters not working

• Check parameter format: ?view=calendar&hideFilters=true
• Use & between multiple parameters
• Encode special characters in search terms

Height not applying

• Use pixels: height="600" not height="600px" in iframe
• Check parent container height restrictions
• Minimum height is 300px, maximum is 1200px

Colors reverting to default

• Verify hex format: #F55E12 (with #, 6 characters)
• Check for typos: primaryColor not primary-color
• Test with simple colors first: #FF0000 (red), #0000FF (blue)

Testing Integration#

Quick test checklist:

1. Widget loads and displays content
2. Clicking classes opens booking page
3. Filters work (if enabled)
4. Widget responds correctly on mobile
5. Colors match your brand

If still having issues:

• Test in incognito/private browser window
• Try different browser (Chrome, Safari, Firefox)
• Check browser console for error messages
• Contact support with your embed code and website URL