---
title: "Datasource (option list)"
slug: "datasource--option-list-"
abstract: "Overview, parameters, and examples for the Datasource object."
---
# Datasource (option list)

> [!note]
> Datasources are currently known as *Option lists*, but the renaming hasn't been fully applied yet.

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `name` | String | Can only contain letters, numbers, dots or underscores. Because it is used as an identifier, this also needs to be unique. |
| `labels` | [`Labels`](https://doc.sitecore.com/ch/en/developers/cloud-dev/labels.html) | Optional. The translation(s) of the canonical name. |
| `type` | String | **Flat** disables nesting of option list items, **Hierarchical** enables nesting option list items. If it set to **Flat** and the **values** array contains nested items, it will throw an error. |
| `values` | Array. <[DatasourceValue`](https://doc.sitecore.com/ch/en/developers/cloud-dev/'datasource-value.md')> | The [Option list items](https://doc.sitecore.com/ch/en/developers/cloud-dev/datasourcevalue--option-list-value-.html) that belong to the option list. |
| `is_system_owned` | Boolean | **false** allows the option list to be editable, **true** locks the option list preventing any further modifications. When creating an option list using the API, you should **always use false**, which is the default value. |

## Examples

```json
{
  "name": "Groceries",
  "labels": {
    "en-US": "Groceries",
    "nl-BE": "Boodschappen"
  },
  "type": "Hierarchical",
  "values": [
    {
      "identifier" : "Bread",
      "labels": {
        "en-US": "Bread",
        "nl-BE": "Brood"
      },
      "values" : []
    },
    {
      "identifier" : "Spreads",
      "values" : [
        {
          "identifier" : "Peanut butter",
          "values" : []
        },
        {
          "identifier" : "Jam",
          "values" : []
        }
      ]
    },
  ],
  "is_system_owned": false
}

```