Docs
  • All For Customers guides
  • Credits, memberships, and orders
  • Customer FAQ
  • Health information and consent
  • Manage bookings and appointments
  • Profile, payment methods, and settings
  • Wallet and gift cards
  • Your customer account
  • All For Teachers guides
  • Manage Attendance
  • Manage Your Profile
  • Teacher Dashboard Overview
  • Teacher FAQ
  • View Your Payslips
  • View Your Schedule and Attendees
  • All Getting Started guides
  • Attendance policy
  • Booking Policies
  • Contracts
  • Manage Locations and Resources
  • Media Library
  • Notification Settings
  • Plan Features
  • Platform Overview
  • Quick Start Guide
  • Reports
  • Studio Profile & Social Links
  • Using the Agent
  • Waivers & Terms
  • All Customer Management guides
  • Coupons
  • Customer Bookings
  • Customer Credit Expiry
  • Customer Details
  • Customer List
  • Customer Segments
  • Export Data
  • Leads Management
  • Manage Discounts and Promotional Codes
  • Manage Family memberships
  • Products & Credits
  • Referrals
  • All Classes guides
  • Activity Categories
  • Booking Availability on Class Sessions
  • Calendar
  • Cancelling and Deleting Class Sessions
  • Closing Bookings on a Class
  • Creating Classes
  • Editing Future Class Instances
  • Managing, Extending, and Deleting Class Series
  • Teacher Assignments on Class Instances
  • Waitlists for Classes
  • Workshop vs Course: Which One Should You Use?
  • All Appointments guides
  • Create Appointment Services
  • Customers Managing Their Appointments
  • How Customers Book Appointments
  • Manage Appointment Resources
  • Reschedule or Cancel Appointments
  • Set Availability Schedules
  • View and Manage Appointments
  • All Pricing guides
  • Class Coverage for Products
  • Creating Class Packs
  • Creating Memberships
  • Product Settings Guide
  • Product Types Overview
  • Share Class Packs and Memberships Online
  • All Products guides
  • Creating Physical Products
  • All Troubleshooting guides
  • Common Issues & Solutions
  • All Payments & Billing guides
  • Abandoned Checkout Recovery
  • Annual summary
  • Billing Details & Invoices
  • Booking & Checkout Settings
  • Gift Cards
  • Invoice vs Receipt: What Naayya Provides
  • Payment Methods & Payouts
  • Payment Review
  • Payment Troubleshooting
  • Point of Sale
  • Record Offline Payments
  • Set Up Get Paid
  • Tax Settings
  • All Integrations guides
  • Add a Lead Form to Your Website
  • Website Integration
  • Website Integration Troubleshooting
  • What Customers See in Website Integrations
  • All Email Marketing guides
  • Create Instagram Content
  • Domain Verification Setup
  • Getting Started with Email Marketing
  • Managing Email Templates
  • Sending Email Campaigns
  • Sending Quick Emails
  • Using the Email Designer
  • All Automations guides
  • Editing an Automation
  • Getting Started with Automations
  • All Team & Access guides
  • Access Control
  • Adding Staff Members
  • Managing Teacher Profiles
  • People Overview
  • Provider Profiles
  • Public Profiles for Staff Who Teach
  • Roles & Permissions
  • Staff Management
  • Teacher Status Management
  • Teaching Team
  • User Roles
  • All Finance guides
  • Pay Rules
  • Payouts
  • Payslips
  • Teacher Payout Calculator
  • All Performance guides
  • Attendance Rates
  • Class Fill %
  • Retention Rates
  • Session Feedback Stats
  • All Community / Feedback guides
  • Private Feedback
  • Public Testimonials
DocsNaayya appBlogContact support
  1. Docs
  2. Integrations
  3. Website Integration Troubleshooting
Open app

Website Integration Troubleshooting

Fix common problems with the Naayya schedule widget or lead form

Use these checks for the v2 schedule widget or lead form. If your site still uses the classic v1 embed, see Classic embed (v1) at the end of this article.

Widget or form not showing#

  • Confirm that you pasted the complete snippet: the module script line and the matching <naayya-schedule> or <naayya-lead-form> element.
  • Check that the schedule's business-id matches the value in the snippet from Copy embed code on the Website Embed page. For a lead form, check that embed-key is the issued public key for the business.
  • Put the code in an HTML, Custom HTML, Code, or Embed HTML block. A rich-text block may display the tags as text instead of loading them.
  • Confirm that the script URL in the snippet is the current v2 URL: https://www.naayya.com/plugin/v2/loader.js for the schedule, or https://www.naayya.com/plugin/v2/naayya-lead-form.js for the lead form.
  • The current Admin → Settings → Website Embed page provides schedule setup only. It does not provide a Lead form control or a lead-form snippet. Use the lead-form checks here only if you already have an issued embed key. If you need a key, contact support@naayya.com to ask whether lead-form setup is available for your business.

Colours or fonts do not match#

  • By default the schedule follows your saved business brand. If it looks wrong, check your brand settings first.
  • To style only the embed, return to Admin → Settings → Website Embed, select Customize this embed under Appearance, and set Button color, Background, Text color, Font, or Corner shape.
  • Check the Preview in both Desktop and Mobile layouts, then select Copy embed code again and replace the old snippet on your website. Appearance choices are saved in the snippet, so an old copy keeps the old look.
  • For a manually edited form, check its theme value: light, dark, or auto.

Filters show the wrong classes (schedule)#

  • Check the attribute spelling: locations, teachers, and categories are plural.
  • Use the location and teacher values from the generated code. Category values must match the category names in your class settings.
  • If customers should choose filters themselves, remove the matching pre-filter attribute and do not add hide-filters.
  • The copied code includes hide-filters. To show the filter controls, select Let visitors filter the schedule on the Website Embed page and copy the code again. The page does not write teachers, locations, or categories, so add those attributes by hand if you want a pre-filtered schedule.

A workshop, course, or single-session button is missing#

  • The schedule shows only classes, workshops, and courses that are public. Appointments and retreats never appear.
  • A course appears only when it has an active, published whole-course program. Check the course's program in your admin, then reload the page.
  • A Single session button appears only when that session can be booked on its own and has its own price. Otherwise the card shows only View course.
  • A workshop shows a Tickets from price only when it has its own linked ticket product. Class packs and memberships are not used as workshop prices.
  • Full or Unavailable in place of a booking button means the session cannot be booked online right now.

Lead form problems#

  • Check that the form has an issued embed-key and that the email field is filled in. A business name or slug cannot be used for lead submissions.
  • The visitor must select the consent checkbox before submitting.
  • If the form says This form is not enabled for this website, contact support@naayya.com with the page address and ask whether that origin can be used with the key.
  • If it says Too many submissions, wait a little while and try again.
  • If it says Network error, check the visitor's connection and try again.

Platform notes#

  • WordPress: use a Custom HTML block, not the visual editor.
  • Squarespace: use a Code block. If your schedule does not appear, check the page in a private window: Squarespace hides scripts while you are logged in.
  • Wix: use an Embed HTML element.
  • GoDaddy and other builders: use an HTML or embed section that accepts custom elements.

Performance#

The v2 script is marked async, so it can load without blocking the rest of the page. Keep the script line with the element it loads, and avoid pasting the same snippet repeatedly into a single page.

Still stuck#

  • Test the page in a private or incognito window and in another browser.
  • Check the browser's developer console for a loading error.
  • Send Naayya support the page address, the site builder you use, and the message shown on the page. Do not send private customer details.

Classic embed (v1)#

The older iframe and data-naayya-calendar embed is kept for compatibility, but new setup and current improvements use v2. Replace the v1 snippet with the v2 snippet in Website Integration when you are ready to update the page.

PreviousWebsite IntegrationNextWhat Customers See in Website Integrations

On this page