Who This Is For / When to Use
Use this article if you want to brand your calendar widget, control what information is shown to users, or enable payment functionality during booking.
Important Requirement: Neo Widget Only
Calendar Widget customization works only with the Neo Widget.
Classic widgets do not support advanced customization
Payment and styling options require Neo Widget compatibility
This limitation applies to all sections below.
What You Can Customize
Calendar Widget customization allows you to:
Match widget colors to your brand
Change booking button text
Hide or show calendar details
Control layout and visibility of elements
Preview changes before publishing
Reset all changes to default
Enable payment collection inside the widget
Access Calendar Customization Settings
Navigate to Calendars from the left navigation.
Locate the calendar you want to customize.
Click the Edit (pencil) icon.
Select the Customizations tab.
Customize Widget Colors
You can control the primary visual styling of the widget.
Available Color Settings
Primary Color
Affects buttons, time slots, and interactive elements.Background Color
Controls the background for the date & time selector and form.
Change Button Text
You can customize the booking button text.
Examples:
“Book Now”
“Schedule Appointment”
“Book with Us”
This text appears on the final booking action button.
Control Visibility of Calendar Details
You can hide or show information in the left panel of the widget.
Toggle Options
Calendar title
Calendar description
Duration
Date & time
Recurring details
Time zone
If you do not want the logo to appear, remove it from the Meeting Details tab.
Use Custom Forms with the Widget
Custom forms can be displayed as part of the booking flow.
Best Practices
Match form colors and fonts to the widget
Keep layouts consistent
Avoid visual contrast that breaks the experience
Preview Widget Changes
Before publishing, always preview your widget.
Use Preview Widget to see changes in real time
Adjust colors, text, or visibility as needed
Save Customization Changes
After reviewing your changes:
Click Save
Changes apply immediately to the live widget
Unsaved changes will not appear on booking pages.
[Screenshot: Save button in Customizations tab]
Reset Widget to Default Settings
If needed, you can restore the original widget design.
Click Reset to Default
Restores the default blue and white styling
Removes all custom changes
[Screenshot: Reset to Default option]
Payment Element Integration (Neo & Classic Widgets)
Kyrios supports payment collection directly inside the Calendar Widget.
Supported Payment Gateways
Stripe (Card, Apple Pay, Google Pay, iDEAL, Bancontact)
NMI
Authorize.net
Square
Razorpay
Payment Capabilities
Save cards for future transactions
Zero-value payments (card capture only)
Full or partial payments
Payments for recurring appointments
[Screenshot: Widget customization screen showing payment-enabled setup]
Common Issues and Fixes
Customization options not visible
Confirm the calendar uses the Neo Widget.Left panel still visible after hiding details
Disable Calendar Name, Description, and Details, remove the logo, and turn off “Allow Select Staff.”Design looks inconsistent
Preview changes and ensure custom forms match widget styling.Payment option not appearing
Confirm the calendar is payment-enabled and the gateway is supported.
FAQ
Which calendars support widget customization?
All calendar types support customization, including Event, Class Booking, Round Robin, and Collective calendars. Some features may not apply to service menus.
Do widget customizations work with Classic Widgets?
No. Customization options work only with the Neo Widget.
Can CSS override widget settings?
Yes. Custom CSS overrides standard widget customization options.
Can I completely hide the left panel?
Yes. Disable calendar details, remove the logo, and turn off staff selection.
Are zero-value payments supported?
Yes. Zero-value payments can be used to save card details without charging.
What payment gateways are supported?
Stripe, NMI, Authorize.net, Square, and Razorpay are supported.