> 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/add-ons/introduction.md

## Article Content:

# About the Add-Ons API

The Add-ons API allows you to manage add-ons for business offerings such as [Bookings services](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction.md). Add-ons are optional extras that extend offerings with additional features or longer duration for an extra cost. For example, you might offer a "yoga mat rental" for a fitness class or a "10-minute extension" for a massage appointment.

<blockquote class="tip">

__Tip:__
While this API is currently focused on Bookings services, it's built with a generic architecture that can support other business domains. For now, all documentation and sample flows are Bookings-specific. If you're working with store products, consider using the [Stores Customizations](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/customizations-v3/introduction.md) API instead. <!-- If you're working with menu items, consider using the [Restaurant Item Modifiers](https://dev.wix.com/docs/rest/business-solutions/restaurants/wix-restaurants-new/menus/items/item-modifiers/introduction.md) API.-->

</blockquote>

With the Add-ons API, you can:

- Create and manage add-ons.
- Query and filter add-ons.
- Perform bulk operations on multiple add-ons simultaneously.

## Before you begin

It's important to note the following points before starting to code when using the Add-Ons API with [Bookings services](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction.md):

- Add-ons must be organized into [add-on groups](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-add-on-groups.md) before customers can select them during booking.
- Add-ons can be reused across multiple groups, but each group belongs to only 1 service.


## Use cases

- [Create bookable add-ons for a new group](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/sample-flows.md#create-bookable-add-ons-for-a-new-group).
- [Add add-ons to an existing group](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/sample-flows.md#add-add-ons-to-an-existing-group).
- [Modify add-ons in eCommerce carts](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/add-ons/sample-flows.md#modify-add-ons-in-ecommerce-carts).

## Terminology

- **Add-on**: An optional extra that extends a business offering such as a Bookings service for an extra cost. Add-ons are either duration-based or quantity-based. When used with Bookings services, add-ons must be included in groups before customers can select them.
- **Duration-based add-on**: An add-on that extends the duration of the business offering, specified in minutes. For example, a 10-minute extension for a massage session.
- **Quantity-based add-on**: An add-on that customers can purchase in multiple units up to a maximum quantity per add-on. For example, an equipment rental or product purchase.
- **Add-on group**: A collection of related add-ons linked to a booking service, managed through the [Services V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/about-add-on-groups.md). Groups define the maximum number of different add-ons customers can select from the group and include customer-facing information like prompts and display order.

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

@sdk_package_setup