---
url: /process-functions/dimension-rename.md
description: Renames a dimension.
---

# dimension.rename

Renames a dimension.

The dimension's id doesn't change.

```js
dimension.rename(dimension, newName)
```

## Parameters

| Parameter | Type | Description |
|---|---|---|
| `dimension` | `string` | The dimension's current name or id. |
| `newName` | `string` | The dimension's new name. |

## Returns

`true` when it succeeds, or `false` when the dimension can't be found or another dimension already has the new name.

## Examples

```js
dimension.rename("Prod", "Product");
```