# Data attributes

:::info
**Note:** This preview feature is currently only available in the licensed Business and Enterprise editions.

:::

Data attributes (aka data properties) allow you to store structured information against documents, and will soon allow filtering and cascading of this data.

# Usage

Data attributes you wish to use within the workspace must first be setup under **Settings → Data Attributes**,  here you can define which properties are available and which options they contain.

Once an attribute is defined you will see a new option in the header of each document below the title to **“+ Property”** where the value can be set on a per-document basis.

# API

Data attributes are available through the [API](https://www.getoutline.com/developers#tag/dataattributes), the following endpoints exist and follow existing patterns to create and manage data attributes at the workspace level:


* `dataAttributes.info`
* `dataAttributes.list`
* `dataAttributes.create`
* `dataAttributes.update`
* `dataAttributes.delete`

  

To modify for individual documents you must pass a `dataAttributes` array to `documents.update`, for example:


```typescript
await fetch(apiUrl, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${apiToken}`,
  },
  body: JSON.stringify({
    id: documentId,
    dataAttributes: [
      {
        dataAttributeId: "cd9d8224-2f88-4bdb-9fbf-9c256a9eb496",
        value: "My text value"
      }
    ]
  })
});
```

---

**Documents**

- [Getting started](https://docs.getoutline.com/s/guide/doc/getting-started-CB6Ipl9Cdc)
- [Documents](https://docs.getoutline.com/s/guide/doc/documents-UiH1h0aQFQ)
- [Integrations](https://docs.getoutline.com/s/guide/doc/integrations-eUbAF2WAjF)
- [AI](https://docs.getoutline.com/s/guide/doc/ai-IFCYbrK7EU)
- [Administration](https://docs.getoutline.com/s/guide/doc/administration-GmaueCNdk1)
- [Import data](https://docs.getoutline.com/s/guide/doc/import-data-D2ZvLqz411)
- [Export data](https://docs.getoutline.com/s/guide/doc/export-data-Da6C7HqL8M)
- [Cloud hosting](https://docs.getoutline.com/s/guide/doc/cloud-hosting-CxJbubIhje)