---
url: /cube-functions/descendants.md
description: 'Only Executes Under: Cards'
---

# DESCENDANTS&#x20;

**Only Executes Under:** `Cards`

Returns a list of all descendant elements separated by the defined delimiter.

```js
DESCENDANTS(dimension, hierarchy, parent, delimiter)
```

#### Parameters

* `dimension` - The name of the dimension.
* `hierarchy` - The name of the hierarchy.
* `parent` - The name of the parent element.
* `delimiter` - The delimiter to use between returned elements.

#### Examples

```js
DESCENDANTS("Time", "Default", "2024", ", ")
```

**Result:** `2024 - Jan, 2024 - Feb, 2024 - Mar, ..., 2024 - Dec`
