> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/service-options-and-variants/introduction.md

## Article Content:

# About the Service Options and Variants API
 
 The Service Options and Variants API lets you manage custom options for [services](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/introduction.md).

You can configure options based on:

- The [staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction.md)
  providing the service.
- Appointment duration.
- A custom parameter, such as customer age or equipment type.

Each option includes a list of choices that customers can select when booking a
service. A service variant is a unique combination of all choices made by the
customer during booking. Only a single option is permitted per
service, meaning a variant corresponds directly to 1 choice from that option.

## Before You Begin

Note the following before coding:

- Only 1 `serviceOptionsAndVariants` object is allowed per service.
- Only 1 option is supported per `serviceOptionsAndVariants` object.
- Variants aren't automatically calculated from the specified option and choices
  in the [Create Service Options and Variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/create-service-options-and-variants.md) call.
  Instead, you must manually define all variants when calling
  Create Service Options and Variants.
- After configuring a staff member-based option for a service, Wix Bookings
  automatically adds a new choice and variant when a new staff member is added
  to the service. Each new variant uses the service’s
  `payment.varied.defaultPrice`. Staff member-based choices and variants are
  automatically deleted if a staff member is removed from the service or the
  entire business.

## Use Cases

- [Create staff member-based service variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/sample-flows.md#create-staff-member-based-service-variants).
- [Create service variants based on booked equipment](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/sample-flows.md#create-service-variants-based-on-the-booked-equipment).

## Terminology

- **Option**: A modification of a service based on staff member, event duration,
  or custom parameters (like customer age). Each option includes a list of
  supported **choices** that customers select when booking. Services can have
  only 1 option.
- **Choice**: A specific value for a service **option**. For example, the option
  `ageGroup` may include choices like `child`, `student`, `adult`, and `senior`,
  each potentially priced differently.
- **Variant**: A unique combination of all choices made by the customer when
  booking. For example, `{"time": "afternoon", "ageGroup": "adult", "equipment": "kettlebells"}`.
  Note that since a service can currently only have 1 option, variants are
  limited to that option and its choices.

For a comprehensive glossary of Wix Bookings terms, see [Terminology](https://dev.wix.com/docs/rest/business-solutions/bookings/terminology.md).

## See also

+ [About service payments](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-service-payments.md).
+ [Pricing API](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/pricing-api/introduction.md):
  Preview and calculate the price for a booking.
+ [Pricing Provider service plugin](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/pricing-integration-service-plugin/introduction.md):
  Implement custom pricing logic.

@sdk_package_setup