Wix Bookings allows business owners to accept and manage bookings for their services. This article lists terms and concepts used in Wix Bookings and its APIs.
Appointments are bookings for on-demand services such as haircuts or consultations. Customers choose their preferred time from available slots, with availability calculated based on business hours, service duration, staff working hours, and booking policies.
A booking represents a customer's reservation for a specific service. The booking includes details about the time, location, and participants.
See also:
A fee for a specific booking that's calculated according to the associated booking policy. For example, a cancellation or no-show fee.
The default operating hours when appointment-based services are available for booking. You can use the Locations API to manage individual business hours for each of the business locations.
The person responsible for managing the business that offers services to customers. This can be the actual business owner or a manager, who may or may not be staff members themselves. They make decisions such as confirming or declining a booking.
The Wix Bookings Calendar is the central interface for managing appointments, classes, and courses. It displays business availability, staff schedules, confirmed bookings, and provides tools for scheduling, attendance tracking, and client management. Wix Bookings automatically creates and manages the underlying schedules and events through the Calendar APIs.
CANCELED (booking status)Indicates that the booking has been canceled by the customer. Depending on the policy, the customer may have to pay a cancellation fee.
The maximum number of participants that can book a service.
A label used to group services, helping business owners, app developers, and customers filter and organize services efficiently.
Customers must complete a checkout when booking a service. Wix Bookings integrates with the Wix eCommerce platform to handle payments and order management. To customize the checkout, you can either use the Wix eCommerce Checkout APIs or build your own payment interface and process payments with external providers. For implementation examples, see end-to-end booking flows.
A specific value for a service option that business owners define when setting up varied pricing.
For example, the service option ageGroup may have these choices: child, student, adult, and senior.
Each choice may have a different price, and customers select from these predefined choices when booking.
Classes are scheduled sessions that customers can book individually. For example, drop-in yoga classes or weekly cooking lessons. You can schedule classes on various days of the week, at different times, and with different staff members. When a specific session is fully booked, customers can join a waitlist and are notified if a spot opens up. Unlike courses where customers must book all sessions, class customers can choose which sessions to attend.
CONFIRMED (booking status)Indicates that the business owner has confirmed the booking and it appears in the Wix Bookings Calendar. Bookings can be confirmed in different ways:
Courses are multi-session programs that customers must book in full. For example, an 8-week programming bootcamp or a 3-day certification training program. Business owners set the complete session timeline before offering the course, with courses starting and ending on pre-defined dates. Customers must book all course sessions, while for classes they're free to book only a single session or some sessions.
Amount that customers must pay immediately online when checking out the booking. Only available for services with fixed or varied pricing.
A double booking occurs when a customer attempts to book a service that's already reserved. This can happen when multiple customers book simultaneously. When Wix Bookings detects insufficient availability during booking confirmation, the business must manually resolve the conflict.
Time-specific instances of services, such as an appointment or class session. Wix Bookings automatically creates and manages events via the Calendar APIs when you create services, staff members, or bookings.
A booking object with additional details beyond the basic booking information. Extended bookings include attendance details, refund eligibility, reschedule permissions, and other management data. Use the Extended Bookings API to retrieve this enhanced booking information.
The synchronization between Wix Bookings and 3rd-party calendar services like Google Calendar, Apple Calendar, or Microsoft Outlook. This integration allows bidirectional sync of booking events and availability, preventing double-bookings across platforms. Use the External Calendar API to set up and manage these connections.
The booking form collects customer information required to complete a booking. Forms can include fields for contact details, special requests, service preferences, and custom questions. Learn more about Wix Forms integration.
A custom implementation that extends Wix Bookings functionality through service plugins. Developers can inject custom logic into the booking flow, such as dynamic pricing or availability rules.
Someone who is a registered member in the Wix site and has a login. Unlike visitors, members have persistent accounts and can access member-only features on the Wix site.
Multi-service bookings enable businesses to offer comprehensive service packages where customers can book multiple related services together in a single transaction. For example, a spa package that includes a massage, facial, and manicure, or a fitness package with a personal training session followed by a yoga class. Each multi-service booking contains several single-service bookings. Single-service bookings in the package must be scheduled sequentially with each booking starting when the previous booking ends. Learn more about multi-service bookings.
A pricing category that business owners define when setting up varied pricing for a service. For example, options can include staff member, customer age, appointment time, or equipment type. Each option contains a list of predefined choices that customers can select from.
A record of a customer's purchase in the Wix eCommerce system. All bookings use eCommerce orders to maintain proper records and functionality. When you use an eCommerce checkout, orders are automatically created and contain details about the booking, payment information, and customer data. For custom checkouts, you must manually create an order in the Wix eCommerce platform and update the booking status to complete the booking flow.
PENDING (booking status)Indicates that the booking is waiting to be confirmed or declined by the business. This status is used when the service requires manual business approval.
Bookings are set as PENDING in these scenarios:
Bookings in PENDING status are displayed in the business calendar and may block availability for the time slot, depending on whether the service allows multiple pending booking requests for the same time.
Rules set by the business owner that govern how customers can book and cancel services. Policies define booking windows, cancellation deadlines, participant limits, and other constraints.
When a booking is created, the current policy is saved as a policy snapshot to preserve the original terms. This protects both customers and businesses by maintaining the original agreement terms throughout the booking lifecycle, even if policies change after a booking is made.
Businesses can offer services for free, with fixed pricing, or with varied pricing. Wix Bookings also supports custom pricing integrations through the Pricing Integration service plugin, allowing you to implement dynamic pricing logic. You can also create service packages and memberships using Wix Pricing Plans, which let customers purchase bundles of services or recurring access to bookings. Learn more about service payments.
An asset the business needs in order to provide a service. Each resource has an event schedule that tracks when it's booked. Customers can book a service only if at least 1 resource of each required resource type is available.
A classification that allows Wix Bookings to automatically check resource availability and avoid double bookings. Examples include rooms, equipment, vehicles, or any other custom asset type that requires scheduling and availability management. Staff members are treated as a special resource type with complex scheduling needs and have a separate API.
Organizes events and defines when services are available and when resources are booked. Wix Bookings automatically creates and manages schedules via the Calendar APIs when you create services, staff members, or bookings. Learn more about how Wix Bookings integrates with the Calendar APIs.
A business offering, which can be a class, a course, or appointment-based. For example, a fitness studio may offer 30-minute 1-on-1 personal training sessions by appointment, 1-hour yoga classes every Monday at 7
PM, and introductory HIIT courses consisting of 3 training sessions on specific dates. Learn more about service types.Service plugins are APIs defined by Wix, which you can choose to implement. By doing so, you become a service provider. Then, Wix calls your implementation during a specific flow, receives your response, and continues the flow considering your returned data. For example, as a pricing provider you can offer custom pricing options for a business using the Wix Bookings Pricing Integration service plugin.
A single occurrence of a service at a specific time. For example, a yoga class on Monday at 7 PM or a haircut appointment on Tuesday at 2 PM. For classes and courses, sessions are pre-created when the service is set up, and customers book into existing sessions. For appointments, sessions are created dynamically when customers make bookings.
A person who provides services for the business. Staff members have both working hour schedules (when they're available to work) and event schedules (when they're booked), which may involve complex scheduling needs. By default, staff members work during the business hours, but you can customize their working hours. Staff members are also eligible to receive tips.
Not all staff members are registered Wix users, and not all Wix users related to the business are staff members.
Information about the life cycle status of the booking.
Booking statuses include: CREATED, PENDING, CONFIRMED, DECLINED, WAITING_LIST, UPDATED, and CANCELED.
Learn more about the booking lifecycle and status transitions.
Specific periods when a service is available for customer bookings. You can use the Time Slots API to find available slots for appointments and classes. The API considers multiple factors to determine availability: service schedules, staff working hours, resource availability, booking policies, and existing bookings. For courses, you can follow the end-to-end booking flow to check availability.
Additional payments that customers can add to their bookings to show appreciation for service quality. Wix Bookings automatically distributes tips among eligible staff members based on configurable settings. Use the eCommerce Tips APIs to manage tip settings, preview tips, and apply tips to eCommerce orders.
The combination of all customer choices for a service's pricing options. Business owners must define all possible variants and their prices when setting up varied pricing for a service. Each variant represents a different combination of the available choices and can have a unique price.
Varied pricing allows businesses to charge for services based on different factors, such as the staff member providing the service or the equipment needed. Wix Bookings supports custom pricing integrations through the Pricing Integration service plugin, allowing you to implement dynamic pricing logic.
Anyone who isn't registered as a member or hasn't logged in to the Wix site. If a visitor creates a booking they're added as a contact to the Wix site. Unlike members, visitors don't have persistent accounts and can't access member-only features on the Wix site.
WAITING_LIST (booking status)Indicates that the class booking is on a waitlist for a fully booked session.
A feature for class services that allows customers to join a queue when sessions are fully booked. When a spot opens due to cancellation, the first person on the waitlist (also called the suggested participant) is notified and given a time window to book the session. If they don't book in the time window, the opportunity passes to the next person on the waitlist. Waitlists aren't available for courses or appointment services.
Wix Pricing Plans are prepaid bundles of services or memberships providing customers access to certain services. You can create service packages and memberships that allow customers to purchase bundles of services or recurring access to bookings.
The specific times when a staff member is working, defined by their working hours schedule. By default, staff members work during the business hours.