---
url: /cube-functions/userelementaccess.md
description: 'Only Executes Under: Cards, Workviews, Processes'
---

# USERELEMENTACCESS 

**Only Executes Under:** `Cards`, `Workviews`, `Processes`

Returns the access level a user has for an element based on security groups.

```js
USERELEMENTACCESS(dimension, element, user_id)
```

#### Parameters

* `dimension` - The dimension name.
* `element` - The element name.
* `user_id` - The user id. `(optional)`

#### Examples

```js
USERELEMENTACCESS("Time", "2025 - Jan")
```

**Result:** `WRITE_ACCESS`

```js
USERELEMENTACCESS("Time", "2025 - Feb")
```

**Result:** `NO_ACCESS`

```js
USERELEMENTACCESS("Time", "2025 - Jan", "VARIABLE("user-id")")
```

**Result:** `READ_ACCESS`