> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/users-and-permissions/roles-and-permissions-for-command/custom-roles.md).

# Custom Roles

{% hint style="success" %}
Custom Roles replaces the legacy Customize Roles feature under **Admin > Users & Permissions**, now renamed to [Modify Default Roles](/command/users-and-permissions/roles-and-permissions-for-command/customize-roles-and-permissions.md). If your organization previously used Customize Roles to toggle permissions on standard roles, those settings remain unchanged. New role customization should use the Roles page described in this article.
{% endhint %}

Custom Roles lets Organization Admins build roles from the ground up, selecting exactly the permissions a user or group needs and nothing more. This is designed to help organizations apply the principle of least privilege across teams, locations, and job functions.

{% hint style="danger" %}
Custom Roles currently only support Cameras and Workplace permissions. 
{% endhint %}

***

## Create a Custom Role

{% hint style="success" %}
As of May 14, 2026, Custom Roles can only be site-scoped.
{% endhint %}

{% stepper %}
{% step %}
**In Verkada Command, go to All Products > Admin.**
{% endstep %}

{% step %}
**Under Admin > Users & Permissions, click Roles.**
{% endstep %}

{% step %}
**In the right, click Create.**
{% endstep %}

{% step %}
**Enter a unique name for the role.**
{% endstep %}

{% step %}
**(Optional) Select a common template to copy permissions from.**
{% endstep %}

{% step %}
**Review the list of available permissions and toggle each one on or off based on what this role requires.**
{% endstep %}

{% step %}
**In the top right, click Save.**
{% endstep %}
{% endstepper %}

***

## Edit a Custom Role

You can edit an existing custom role at any time from Admin > Users & Permissions > Roles. Changes apply immediately to all users and groups assigned that role.

{% stepper %}
{% step %}
**In Verkada Command, go to All Products > Admin.**
{% endstep %}

{% step %}
**Under Admin > Users & Permissions, click Roles.**
{% endstep %}

{% step %}
**Select the role to edit.**
{% endstep %}

{% step %}
&#x20;**Next to the role name, click** <i class="fa-ellipsis">:ellipsis:</i> **> Edit Permissions.**

Review the list of available permissions and toggle each one on or off based on what this role requires.
{% endstep %}

{% step %}
**In the top right, click Save.**
{% endstep %}
{% endstepper %}

***

## Assign a Custom Role

When picking a role type, find custom roles under the **Custom** section.

<details>

<summary>Users</summary>

#### Grant permissions

1. In Verkada Command, go to **All Products > Admin.**
2. Select **Users & Permissions** > **Users.**
3. Select a user to grant permissions.
4. Click **Manage** to the right of **Site Roles**
   1. From a list of role types, select **Custom.**
   2. Click **Save**.&#x20;

#### Revoke permissions

1. In Verkada Command, go to **All Products > Admin.**
2. Select **Users & Permissions** > **Users.**
3. Select a user to revoke permissions.
4. Click **Manage** to the right of **Site Roles**
   1. From a list of role types, select **Custom.**
   2. De-select the role to remove from the user.
   3. Click **Save**.&#x20;

</details>

<details>

<summary>Groups</summary>

#### **Granting permissions**

1. In Verkada Command, go to **All Products > Admin.**
2. Select **Users & Permissions** > **Groups.**
3. Select a Command group to grant permissions.
4. At the top, click **Roles.**
5. Click **Manage** to the right of **Site Roles**
   1. From a list of role types, select **Custom.**
   2. Click **Save**.&#x20;

#### **Revoking permissions**

1. In Verkada Command, go to **All Products > Admin.**
2. Select **Users & Permissions** > **Groups.**
3. Select a Command group to revoke permissions.
4. At the top, click **Roles.**
5. Click **Manage** to the right of **Site Roles**
   1. From a list of role types, select **Custom.**
   2. De-select the role to remove from the group.
   3. Click **Save**.&#x20;

</details>

***

## Supported permissions

Admins can toggle each permission below when creating a custom role to control what users can view and manage within a site.

{% tabs %}
{% tab title="Cameras" %}
**Site Configuration**

* View Site
* Manage Site
  * Add, remove, and manage user permissions on a site for existing users
  * Create, rename, and delete sites and subsites

**Camera Settings**

* View Camera Details
* Manage Camera Settings
  * Accept face search & biometric compliance setting
  * Manage cloud backup
  * Set privacy mode
  * Set camera read-only mode
  * Apply site device defaults Manage org camera presets
  * Manage device network and access
  * Configure encoding and bandwidth
* Add and Modify Cameras in Site.
  * Add cameras to the organization and the site(s) where they have this permission
  * Delete cameras only from the site(s) where they have this permission
* Set Onboard Video Retention

**Video & Sharing**

* View Live Camera Streams
* View Historical Footage
* Share Camera Live Links

**Analytics & Search**

* Use AI-powered Search
* View People Analytics
* Manage Occupancy Trends
* View Person of Interest Lists
* Manage Person of Interest Lists
* View License Plates of Interest
* View License Plate Analytics
* View Vehicle Analytics

**Archives**

* View Public Archives
* Create Public Archives
* Create Private Archives
* View All Private Archives
* Download Archives
* Delete Archives
* Share Archive Live Links
  {% endtab %}

{% tab title="Workplace" %}
**Site Configuration**

* View Guest Site
* Manage Guest Site

**Visitor Management**

* View Approved Lists
* Modify Approved Lists
* View Deny Lists
* Modify Deny Lists
* Override Denials
* View Guest Phone Numbers
* Manage Visitor Security Screening Results
* Manage Applicant Security Screening Results

**Incidents Response**

* View Responses
* Launch Responses
* End Responses
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/command/users-and-permissions/roles-and-permissions-for-command/custom-roles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.