---
url: /process-functions/dimension-aliases.md
description: Returns the aliases in a dimension.
---

# dimension.aliases

Returns the aliases in a dimension.

```js
dimension.aliases(dimensionName)
```

## Parameters

| Parameter | Type | Description |
|---|---|---|
| `dimensionName` | `string` | The dimension's name. |

## Returns

The aliases as a JSON string, read with `JSON.parse()`. Each alias has an `id`, `name` and `created_at`. Returns `"Error: could not find the dimension specified."` when the dimension can't be found.

## Examples

```js
const aliases = dimension.aliases("time");
```