Mintlify Sandbox

Coding Examples

Overview

Sled Tests

Go Headless

Studio Two

Dashboard Extensions

Backend Extensions

Site Extensions

Extend Websites with SDK

Wix APIs and References

Build Apps

Frontend Modules

Client (Deprecated)

API Preview

Wix CLI

Contexts

Ricos

Extend Websites with Velo

API Reference

Velo

Picasso

# Data Reference

The `data` section of a context provider manifest declares configuration inputs. In Studio Two, a Wix user sets these inputs when configuring a **Data Source**, and the values arrive on the provider component as React props.

## Example

The following `data` section defines 2 inputs for a team context:

```ts
data: {
  showInactive: {
    dataType: 'booleanValue',
    displayName: 'Include Inactive Teammates',
    defaultValue: false,
  },
  pageSize: {
    dataType: 'number',
    displayName: 'Teammates Per Page',
    defaultValue: 12,
  },
}
```

## Data item fields

A data item supports the following fields:

| Field | Required | Description |
| --- | --- | --- |
| `dataType` | Yes | [Type](fallback::https://dev.wix.com/docs/site-extensions/context-providers/context-provider-data-types) of value the input accepts. |
| `displayName` | No | Input name shown in the editor. |
| `defaultValue` | No | Initial editor value. It must match the runtime prop shape. |
| `disableDeletion` | No | Whether a Wix user can clear the input in the editor. |
| `arrayItems` | When `dataType` is `arrayItems` | Definition for each element in an [array](fallback::#arrays). |
| `data` | When `dataType` is `data` | Fields in a [nested object](fallback::#nested-objects). |
| `textEnum` | When `dataType` is `textEnum` | Allowed [string options](fallback::#text-enums). |

## Empty data

If the provider doesn't need configuration, set `data` to an empty object. The provider component still runs, and the editor doesn't show configuration fields.

```ts
data: {}
```

## Arrays

For an array, set `dataType` to `arrayItems` and define each element under `arrayItems.dataItem`:

```ts
data: {
  pinnedTeammateIds: {
    dataType: 'arrayItems',
    displayName: 'Pinned Teammates',
    arrayItems: {
      dataItem: {
        dataType: 'text',
        displayName: 'Teammate ID',
      },
    },
  },
}
```

<blockquote class="warning">

**Warning:** Arrays in `data` use `arrayItems.dataItem`. Arrays in `context` use `arrayItems.item`.

</blockquote>

## Nested objects

For a nested object, set `dataType` to `data` and define its fields under `data.items`:

```ts
data: {
  defaultFilter: {
    dataType: 'data',
    displayName: 'Default Filter',
    data: {
      items: {
        department: {
          dataType: 'text',
          displayName: 'Department',
        },
        location: {
          dataType: 'text',
          displayName: 'Location',
        },
      },
    },
  },
}
```

## Text enums

For a fixed set of strings, set `dataType` to `textEnum` and list the choices under `textEnum.options`:

```ts
data: {
  sortOrder: {
    dataType: 'textEnum',
    displayName: 'Sort Order',
    defaultValue: 'name_asc',
    textEnum: {
      options: [
        { value: 'name_asc', displayName: 'Name: A to Z' },
        { value: 'name_desc', displayName: 'Name: Z to A' },
      ],
    },
  },
}
```

## See also

- [About the Context Provider Manifest](fallback::https://dev.wix.com/docs/site-extensions/context-providers/about-the-context-provider-manifest)
- [Context Reference](fallback::https://dev.wix.com/docs/site-extensions/context-providers/context-reference)
- [Context Provider Resources Reference](fallback::https://dev.wix.com/docs/site-extensions/context-providers/context-provider-resources-reference)

Field	Required	Description
`dataType`	Yes	Type of value the input accepts.
`displayName`	No	Input name shown in the editor.
`defaultValue`	No	Initial editor value. It must match the runtime prop shape.
`disableDeletion`	No	Whether a Wix user can clear the input in the editor.
`arrayItems`	When `dataType` is `arrayItems`	Definition for each element in an array.
`data`	When `dataType` is `data`	Fields in a nested object.
`textEnum`	When `dataType` is `textEnum`	Allowed string options.