# About the Labels API

The Labels API provides functionality for managing contact labels on a site. Labels allow Wix users to segment or categorize contacts, customizing their contacts organization according to their needs. For example, they can use labels to target specific audiences for email campaigns or bulk actions. 

With the Labels API, you can:
- Create, manage, and delete labels. 
- Retrieve information about existing labels. 

Learn more about [Creating and Using Contact Labels](fallback::https://support.wix.com/en/article/creating-contact-labels).

## Before you begin

It's important to note the following points before you begin to code:
- When you delete a label from a site, you also remove that label from all contacts it applies to.
- Label keys can't be changed once created. 

## Terminology

- **Label**: A tag that is applied to contacts to help Wix users organize and group contacts with shared characteristics. Labels can be either user-defined or system-defined. 
  - **User-defined label**: A label that is custom created by calling the Find Or Create Label method.
  - **System-defined label**: A label that is pre-defined in a site and can't be deleted from the CRM.

@sdk_package_setup

# Contact Labels: Supported Filters and Sorting

The following table shows field support for filters and sorting
for the label object:

| Field         | Supported Filters                          | Sortable |
| ------------- | ------------------------------------------ | -------- |
| `key`         | `$eq`, `$ne`, `$in`                        |          |
| `displayName` | `$eq`, `$ne`, `$in`, `$startsWith`         | Sortable |
| `createdDate` | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte` | Sortable |
| `updatedDate` | `$eq`, `$ne`, `$gt`, `$lt`, `$gte`, `$lte` | Sortable |
| `namespace`   | `$eq`, `$ne`                               |          |
| `labelType`   | `$eq`                                      |          |

__Related content:__
[API Query Language](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::8158a590-f60c-4606-9fed-16a34e275f3a*fallback::https://dev.wix.com/api/rest/getting-started/api-query-language),
[Query Labels](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::644f57b7-19f5-4120-a20e-5e61852c6993slug::query-labels*fallback::https://dev.wix.com/api/rest/contacts/labels/query-labels)

Coding Examples

Sled Tests

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

API Reference

Velo

Picasso

GraphQL (Alpha)

List Labels