Skip to content
Driive Help Center home
Driive Help Center home

Troubleshooting Deployment

Ran into a problem getting your booking page live? This guide covers the most common deployment issues and how to fix them.

Widget not appearing on your website

You pasted the embed code, but the "Book Now" button isn't showing up.

Check that both snippets are installed

The widget needs two pieces: the script tag (loaded once, in your <head> or before </body>) and the button element placed where you want the button to appear. If either one is missing, nothing shows up.

Fix: Make sure your page includes both:

<script src="https://embed.getdriive.com/widget.js" defer></script>

<driive-btn org="your-org-slug"></driive-btn>

Clear your cache

Browsers and many website platforms cache pages aggressively. You might have added the code correctly, but your browser is showing a cached version without it.

Fix:

  • Browser cache: Press Ctrl + Shift + R (Windows) or Cmd + Shift + R (Mac) to do a hard refresh.
  • WordPress: Clear your caching plugin (WP Rocket, W3 Total Cache, LiteSpeed, etc.) and any CDN cache (Cloudflare, etc.).
  • Squarespace / Wix: These platforms can take a few minutes to propagate changes. Wait 5 minutes and try again.

Check for JavaScript errors

Another script on your page might be throwing an error that prevents the Driive widget from loading.

Fix: Open your browser's developer console (F12 or Cmd + Option + J on Mac) and look for red error messages. If you see an error from a different script, fixing that script may resolve the widget issue. If the error is from the Driive script itself, contact support.

Verify the embed code is correct

Make sure you copied the full embed code from Driive without any modifications. A missing character or extra space can break it.

Fix: Go to Setup > Website Widget in Driive, copy both snippets again, and replace whatever is currently on your site with the fresh copy. Double-check the org attribute on the button matches your organization's slug.

Check for ad blockers

Some browser ad-blocking extensions block third-party scripts, which can prevent the widget from loading.

Fix: Disable your ad blocker temporarily and refresh the page. If the widget appears, the ad blocker was the issue. Most customers won't have this problem, but it's good to be aware of during testing.

Booking link returning a 404 error

A customer or you clicked a booking link and got a "Page Not Found" error.

Verify your organization slug

Your booking page URL includes your organization slug (e.g., .../book/johnson-roofing). If the slug was changed or is misspelled in the link you shared, it will return a 404.

Fix: Open any appointment type under Setup > Appointment Types and check the Booking URL on its General tab. Copy the correct link and update it wherever you shared the old one.

Check that the appointment type is active

Per-appointment-type direct links only work for active appointment types. If you deactivated or deleted the appointment type, its direct link stops working.

Fix: Go to Setup > Appointment Types and check the status of the appointment type. Reactivate it if needed, or share a link to a different active appointment type.

Widget showing wrong branding

The widget appears, but it has the wrong logo, colors, or company name.

Update branding settings

The widget pulls branding from your organization settings. If it looks wrong, the settings may be outdated or not saved.

Fix:

  1. Go to Setup > Company > Branding.
  2. Verify your logo, primary color, and accent color are correct.
  3. Click Save (even if you didn't change anything — this forces a refresh).
  4. Hard-refresh your website (Ctrl + Shift + R or Cmd + Shift + R).

Check which organization you're in

If you manage multiple organizations, you might be looking at the widget for the wrong one. Each organization has its own embed code.

Fix: Open the organization switcher in the sidebar, confirm you're in the correct organization, then re-copy the embed code from Setup > Website Widget.

Widget status stuck on "Setup"

You've installed the widget, but the page at Setup > Website Widget still shows Setup instead of Live.

Confirm the widget is actually loading

The status flips to Live once Driive detects the widget on a live site. If the script or button snippet isn't loading (see the sections above), the status stays at Setup.

Fix: Visit your website, verify the button appears and opens the booking flow, then check the widget page again.

Refresh the page

Occasionally the status badge doesn't update in real time after installation.

Fix: Refresh the Setup > Website Widget page. If the widget is installed correctly, the status should update to Live.

Platform-specific issues

WordPress

Problem: Widget doesn't appear after adding the code.

  • Check your theme. Some themes don't have an easy way to add code before </body>. Use the Insert Headers and Footers plugin (or a similar plugin like WPCode) to add the snippet to the site footer.
  • Caching plugins. WordPress caching plugins are the most common cause of "it's not showing up." Clear the cache in your caching plugin, and if you use Cloudflare, purge the Cloudflare cache as well.
  • Security plugins. Plugins like Wordfence or Sucuri may block external scripts. Check their settings and whitelist the Driive domain.

Squarespace

Problem: Code injection doesn't seem to work.

  • Code injection is a premium feature. Squarespace's Code Injection feature is only available on Business and Commerce plans. If you're on a Personal plan, you'll need to upgrade.
  • Paste in Footer, not Header. Use the Footer code injection field, not the Header. This ensures the script loads after page content.

Wix

Problem: Custom code isn't loading.

  • Custom code requires a premium plan. Free Wix sites don't support custom code injection. Upgrade to a premium plan to use the widget.
  • Use the correct placement. When adding custom code in Wix, set the placement to Body - End and apply it to All Pages.
  • Disable Wix's built-in site optimizer temporarily to see if it's interfering with the widget script.

Webflow

Problem: Widget appears in the editor but not on the published site.

  • Publish your site. Webflow custom code only goes live after you hit Publish. Changes in the editor preview don't affect the live site.
  • Check your hosting plan. Custom code is available on all Webflow hosting plans, but verify it's in the Project Settings > Custom Code > Footer Code section.

GoDaddy Website Builder

Problem: Widget doesn't show after adding an HTML block.

  • HTML blocks render differently. GoDaddy's builder may sandbox HTML blocks. Try placing the code in a site-wide custom code section if available, rather than an in-page HTML block.
  • Publish and wait. GoDaddy can take a few minutes to propagate changes. Publish, wait 5 minutes, and hard-refresh.

Still stuck?

If you've tried the steps above and your deployment still isn't working:

  1. Take a screenshot of the issue (the widget area, the error page, or the widget status badge).
  2. Note which platform your website runs on.
  3. Contact Driive support with the screenshot and platform details. The support team can help diagnose the issue quickly.

Related articles

Powered by Plain