> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meridian.surf/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit a Role

> Modify role name, color, hoist, or mentionable settings.

The **Edit a Role** block lives in the **Roles** palette category. Modify role name, color, hoist, or mentionable settings.

## What it does

Modify role name, color, hoist, or mentionable settings.

## Configuration

Open the block in the builder sidebar to configure these fields.

### `role_id`

**Type:** `role`. Required.

Role to modify.

### `new_name`

**Type:** `string`.

Leave blank to keep the current name.

### `new_color`

**Type:** `string`.

Hex color. Leave blank to keep the current color.

### `hoist`

**Type:** `boolean`.

Display separately in the member list.

### `mentionable`

**Type:** `boolean`.

Allow @mentions for this role.

## See also

* [Roles](/builder/action-blocks/roles) — Browse all blocks in the Roles category.