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

# RoleDefinition

[API Reference](/api-reference/modelence/server/type-aliases/../../../index) / [modelence](/api-reference/modelence/server/type-aliases/../../index) / [server](/api-reference/modelence/server/type-aliases/../index) / RoleDefinition

> **RoleDefinition** = `object`

Defined in: [packages/modelence/src/auth/types.ts:88](https://github.com/modelence/modelence/blob/f614ecc6811cdda9670d612872c8ff49a49c5e28/packages/modelence/src/auth/types.ts#L88)

Defines a role that can be assigned to users.

Roles are registered via the `roles` option in [AppOptions](/api-reference/modelence/server/type-aliases/AppOptions) and
are synced to the Modelence Cloud dashboard for user management.

## Example

```typescript theme={null}
import { startApp } from 'modelence/server';

startApp({
  roles: {
    admin: { description: 'Full access to all features' },
    editor: { description: 'Can edit content' },
    viewer: {},
  },
});
```

## Properties

| Property                              | Type     | Description                                                                     | Defined in                                                                                                                                                               |
| ------------------------------------- | -------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <a id="description" /> `description?` | `string` | Human-readable description of the role, shown in the Modelence Cloud dashboard. | [packages/modelence/src/auth/types.ts:90](https://github.com/modelence/modelence/blob/f614ecc6811cdda9670d612872c8ff49a49c5e28/packages/modelence/src/auth/types.ts#L90) |