Kpay Alumni

Embed the Appointments Booking Widget on your Website

You can embed a Square Appointments booking widget or button on your existing website, making it easy for your clients to find your availability and book an appointment.


We know the embed process can be confusing, so we put together a how-to guide for some common website builders - Squarespace, Wix, Weebly, and Wordpress. Keep in mind that our community admins and support team can’t help troubleshoot non-Square products, since we’re not the experts! If you’re having any trouble with your website management system, you’ll have to reach out to them directly, or ask fellow sellers here in the community.


Let’s get to it!


The first thing you’ll need is the code for your Square Appointments widget, available from the Square dashboard. 



To get your embed code from your Square dashboard:


  1. Visit the Online Booking tab of your Appointments dashboard > click Website Embed.
  2. Copy the block of code provided.
  3. In your website builder, you’ll paste this block of code and then preview and publish.

Dashboard embed code.jpeg


To embed the widget on your Squarespace website:


  1. From your Squarespace Pages menu, select or create the page where you’d like to embed your booking widget. 
  2. Click on the area of the page where you’d like the widget embedded and click Add Block.Squarespace0.jpeg
  3. Select the Code < / > icon. Squarespace1.jpeg
  4. Remove default code from text box and paste the code provided in your Appointments dashboard > click ApplySquarespace2.jpeg
  5. Click Save. Once you exit editing mode and refresh the page, the embedded widget will display.

Read more about Using the Code Block on the Squarespace.



To embed the widget on your Wix website:


  1. From your Wix site Editor, click the + Add icon from the menu on the left-hand side.
  2. Then click More and click HTML iframeScreenshot 2018-08-22 at 07.57.41.png
  3. Drag and drop and resize the embed box to position it as you’d like it to appear on your site.
  4. Click Enter Code. Screenshot 2018-08-22 at 08.17.12.png
  5. In the HTML iFrame pop up box (see the screenshot above), paste the full embed code from your Square Appointments dashboard.
  6. Click Apply > and finally click Publish to publish the changes to your site.  Wix3.jpeg

Read more about adding HTML code with Wix.



To embed the widget on your Weebly website:


  1. From your Weebly site editor, click and drag the embed code button from the toolbar into the desired section of your page. Weebly1.jpeg
  2. Resize margins as needed.
  3. Click within margin to set custom HTML > click Edit Custom HTMLWeebly2.jpeg
  4. Paste embed code > click outside of embed box to set changes.
  5. Click “Publish”. Weebly3.jpeg

Note: embed code won’t take up the entire page as previewed. Consider resizing it accordingly after publishing and refreshing the page.


Read more about creating widgets and embedding code with Weebly.



To embed the widget on your WordPress website:


  1. Select/create page where you’d like to embed your booking widget.
  2. Click the HTML tab in the page editor > paste code provided in your Appointments dashboard.Wordpress1.jpeg
  3. Click Preview or Publish.

Read more about HTML with Wordpress.

We hope this makes embedding your appointments widget a little easier. Feel free to comment here to let us know how it’s going!

Message 1 of 35

Re: Embed the Appointments Booking Widget on your Website

How do I customize css for the embed to match my site's styling?

Message 2 of 35

Re: Embed the Appointments Booking Widget on your Website

Great question @luxbarber 


You're able to change the button colors, but full customization would be a feature request. This specific feature request isn't something that's on our road map at the moment, but I'll let the right teams know that it's something you'd like to see available in the future 👍🏼

Message 3 of 35

Re: Embed the Appointments Booking Widget on your Website

This is pretty crucial for me, and I would imagine for others. This needs to become a priority on your road map! The solution of going to a new page/tab on Square to do the actual booking is a disconnect for users, and the business-specific branding is poor. You really need to provide two things:


1) The ability to truly and easily embed the widget on sites using WordPress. You need to make a WP plug-in that provides short codes so we can place the widget on our own site. And within that, much more control over font sizes, colors, overall size and layout. I can force it to embed on my WP site through code tinkering, but the widget's display area is way too large for my pages, and the styling is totalyl different.


2) Until then, if we have to bounce out to Square, MUCH better control over the appearance of the booking page/widget, even if it's on Square - better branding, and ability to adjust font sizes, colors, overall size and layout. Maybe even allow linking to a CSS file on our site so we can tinker.


BookFresh had this down much better, so I'm surprised you don't just follow their lead since you own BF now. We like Square's integration with payment and other features, so we'll probably live with the functionality as-is for now, but it leaves a lot to be desired, especially compared with competitors.

Message 4 of 35

Re: Embed the Appointments Booking Widget on your Website

@Antbalf! I'm sorry that the current widget hasn't met your expectations but I really appreciate your detailed feedback. I''ll share it with the Appointments Product team. I don't have a timeline on when we'll be able to offer additional customization, but the Appointments team is actively tracking this. If we have any updates in future we'll update this thread. 👍

Message 5 of 35

Re: Embed the Appointments Booking Widget on your Website

@Helen - any updates on this? Hoping to be able to drop the appointments feature into my Squarespace site -- but want to make sure I can match the design / styling of the rest of my site.

Message 6 of 35

Re: Embed the Appointments Booking Widget on your Website

"You're able to change the button colors"
How can I change the button colors? I either can't find the documentation, or the documentation I'm looking at is inadequate. I'm embedding in a WordPress site, and the only instructions are to copy and paste a code snippet into a new block. There's nothing in that documentation about how to customize the css this block uses, or where to include css this block uses. 

Message 7 of 35

Re: Embed the Appointments Booking Widget on your Website

This isn't working on WordPress.com - it's stripping the javascript code.

Message 8 of 35

Re: Embed the Appointments Booking Widget on your Website

Thanks for flagging @InspiredLifeCoa and I'm so sorry for the late reply! 


If you're still experiencing this issue go ahead and contact our Support team directly so we can take a closer look. It might also be helpful to reach out to WordPress about this (if you haven't already) to see if the issue might be on their side. 


Message 9 of 35

Re: Embed the Appointments Booking Widget on your Website

same issue here, the script takes over my whole page.  😞

Message 10 of 35