# List schema

Learn how to define schemas for lists.

List schemas describe collections of items such as lists of tags, images, or products.

![List form](/assets/reference/content/schema/list-banners.png)

The input for a list schema is a list of fields that allows adding, removing, and reordering items.

You can also customize item labels to make the content easier to identify. By default, items are numbered sequentially (Item 1, Item 2, etc.), so renaming them helps you see what each one represents at a glance.

[Watch the video](/assets/reference/content/schema/rename-items.mp4)

## Examples

Below are some examples of list schemas:

**Basic**

```json
{
  "type": "list",
  "items": {
    "type": "text"
  }
}
```

**Constraints**

```json
{
  "type": "list",
  "items": {
    "type": "text"
  },
  "itemLabel": "Tag",
  "minimumLength": 1,
  "maximumLength": 3
}
```

## Properties

The following properties are available for list schemas:

- `type`: `string`

  The type of the schema. Always `list` for list schemas.

- `items`: [`Schema`](../introduction#schema-types)

  The schema of the items in the list.

- `itemLabel`: `string` (optional)

  A label to prefix each item in the list, up to 60 characters. For example, "Tag" for "Tag 1", "Tag 2", and so on.

  ![Item label](/assets/reference/content/schema/itemLabel.png)

- `minimumLength`: `number` (optional) (default: 0)

  The minimum number of items (inclusive).

- `maximumLength`: `number` (optional) (default: 30)

  The maximum number of items (inclusive).
