About the Categories V2 API

The Bookings Categories V2 API allows you to manage the order in which Wix Bookings displays services on both a site and its dashboard. Within a category, services are ordered by the service's sortOrder field.

With the Categories V2 API, you can:

  • Retrieve categories.
  • Create, update, and delete categories.
  • Change the order in which categories appear.

Before you begin

It's important to note the following points before starting to code:

  • Wix Bookings must be installed on a site before you can use the Categories V2 APIs. Upon installation, Wix Bookings creates a default category with {"name": "Our Services"}.
  • If you delete a category, any services still linked to it remain associated with the deleted category. These services appear in the business dashboard, but aren't visible to customers until reassigned to an existing category.
  • Each site can have up to 100 categories.
  • You can't connect a service to more than a single category.
  • Wix Bookings assigns sortOrder values with large gaps between adjacent categories, allowing efficient reordering without updating the entire category list. When gaps become too small, the system automatically reassigns new values to restore larger gaps.

Use cases

Terminology

  • Category: Categories organize Bookings services by controlling the order in which customers see services on the site and business owners see them in the dashboard.
  • Default category: A category named Our Services that's created automatically during the installation of Wix Bookings app. You can rename or delete the default category.

For a comprehensive glossary of Wix Bookings terms, see Terminology

See also

Did this help?