The scheduling widget lets clients book appointments directly from your website. It shows your real-time availability and follows your standard scheduling workflow — bookings appear in your Oasys calendar like any other appointment.
⚠️ Not seeing the widget in your Settings? The scheduling widget is not enabled by default. Contact support to have it enabled for your account.
In this article:
1. Setting up the widget
Where to find it: Go to Settings → Scheduling → Scheduling Widget.
Before you can activate the widget, configure two required fields:
Website URL — the domain where you'll embed the widget (e.g., https://yourwebsite.com). Include https:// and add both www and non-www versions if needed. Comma-separate multiple URLs.
Default Service — the service type clients will book. This sets the session duration and pricing shown in the widget.
Once both are set, click Activate Widget. The embed code and live preview become available.
💡 You can deactivate the widget anytime from the settings menu (gear icon, top-right). Any changes to Website URL or Default Service require clicking Save Changes to take effect.
2. Availability settings
By default, the widget uses your general availability (from Settings → Scheduling → Availability). Clients see the same open slots as any other booking method.
You can optionally enable custom widget availability to set different hours specifically for widget bookings:
Configure specific days and time ranges.
Add multiple time blocks per day (e.g., 9am–12pm and 2pm–5pm).
Days without configured blocks show as unavailable.
This is useful for reserving certain hours for website bookings or offering different availability for new clients coming through your site.
⚠️ Note: If custom availability is enabled but no time blocks are configured, the widget will show no available slots.
3. Customizing the appearance
Match the widget to your website's design with these theme options:
Primary Color — buttons, links, and accent elements
Text Color — primary text color for content
Background 1 — widget container background
Background 2 — calendar section background
Font Family — choose from common web fonts or use system default
Use the color pickers or enter hex codes directly. View changes in the Live Preview panel, then click Save Theme.
💡 The embed code automatically includes your saved theme settings. After saving, your live widget will update within a few minutes.
4. Embedding on your website
After activating, you'll see an embed code in the Embed Code section. Copy the entire snippet and paste it into your website where you want the calendar to appear.
In most website builders (Squarespace, Wix, WordPress, etc.), look for a "Custom HTML," "Code," or "Embed" block. Add one to your page, paste the code, and save.
If someone else manages your website, send them the embed code and let them know where you'd like it placed.
💡 Tip: After adding the widget to your site, test it by booking a test appointment yourself. You can cancel it afterward from your calendar.
5. Troubleshooting
Widget doesn't appear on my website
Verify the widget is activated in Settings.
Check that your website URL is in the allowed origins (include https://).
Add both www and non-www versions if you use both.
Clear your browser cache or try an incognito window.
Ensure the embed code is pasted correctly without modifications.
Widget shows but no available times
Check your availability in Settings → Scheduling → Availability.
If using custom widget availability, ensure time blocks are configured.
Verify the selected service type has a duration set.
Check that you haven't blocked time on your calendar.
Theme changes aren't showing
Make sure you clicked Save Theme.
Copy the embed code again after saving (it includes your theme).
Clear your browser cache on your website.
Changes may take a few minutes to propagate.
Frequently asked questions
Do I need technical skills to set this up?
No. You just copy a code snippet and paste it into your website builder. You don't need to understand or modify the code.
Does the widget work on mobile?
Yes. The widget is responsive and adapts to mobile screen sizes.
Are bookings through the widget real appointments?
Yes — they create real appointments that appear in your Oasys calendar and follow your standard scheduling workflow.
Can I use the widget on multiple pages or websites?
Yes. Add multiple website URLs in the settings (comma-separated), then paste the embed code on any page across those sites.