# Attribute lists

> An Attribute list is an attribute with a predefined set of options that categories can carry.
{/* generated:versioned-pages - edit _pm-authored, not this file */}

An **Attribute list** is an attribute whose values come from a **predefined set of options** - think "Color" with values Red, Green, Blue, or "Size" with S, M, L. It has a translatable `name` and the `categories` it applies to.

The attribute is the definition; each option is an [Attribute list value](/api/product-management/attribute-list-values/), and a product references the option(s) that apply to it.

## The Attribute list object

## Conventions

All requests require an OAuth 2.0 bearer token:

```
Authorization: Bearer <token>
```

For the translatable `name`, set `Flowkiwi-Locale`. `PATCH` uses [JSON Merge Patch](https://datatracker.ietf.org/doc/html/rfc7396).
