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

# Users & roles

> Invite people to your company, assign roles, change a user's role, and revoke access.

The **Users** tab of the admin area is where you manage who can sign in to your
company's AI Insurance instance and what each person is allowed to do. Open it
by selecting your **company name** at the bottom of the left sidebar, then the
**Users** tab.

<Note>
  The Users tab is only visible to users whose role allows managing users — of
  the standard roles, that's **Carrier Admin** (and Super Admin). Other roles
  don't see the tab at all.
</Note>

<Frame caption="The Users tab: every member of your company, with an inline role editor and per-row actions.">
  <img src="https://mintcdn.com/ai-insurance-fmv1/XH5fzBvkqbS_uBK9/assets/app/admin/users-table.png?fit=max&auto=format&n=XH5fzBvkqbS_uBK9&q=85&s=d1c70ea0b208c4f59cbe6fc61e1f12f9" alt="The admin Users tab showing a table of users with Name, Email, Role, and Actions columns, an inline role dropdown per row, resend-invite and remove icons, and an Add New User button at the top right." width="2376" height="1132" data-path="assets/app/admin/users-table.png" />
</Frame>

The table lists every user in your company with their **Name**, **Email**,
**Role**, and per-row **Actions** (resend invite, remove). Your own row is
special: you can't change your own role or remove yourself, so the role editor
is disabled and the action icons don't appear on it.

## Invite a user

<Steps>
  <Step title="Select Add New User">
    The **Add New User** button sits at the top right of the Users card.
  </Step>

  <Step title="Fill in the dialog">
    Pick a **Role** (the dropdown shows each role's name and description), then
    enter the user's **Name** and **Email**. The **Send email notification to
    the added user** checkbox is checked by default — leave it on to send the
    invite email.
  </Step>

  <Step title="Select Add User">
    The user is added to your company with the chosen role. If you left the
    notification on, they receive an *"Account Added To \<your company>"*
    email telling them which role they were given and where to sign in.
  </Step>
</Steps>

<Frame caption="The Add New User dialog: role first, then name and email.">
  <img src="https://mintcdn.com/ai-insurance-fmv1/XH5fzBvkqbS_uBK9/assets/app/admin/add-user-dialog.png?fit=max&auto=format&n=XH5fzBvkqbS_uBK9&q=85&s=1b1a79ef5983792c43394060f3bc5c11" alt="The Add New User dialog with a Role dropdown, Name and Email text fields, a checked 'Send email notification to the added user' checkbox, and Add User / Cancel buttons." width="1348" height="752" data-path="assets/app/admin/add-user-dialog.png" />
</Frame>

A few things to know about invites:

* **The email address is the identity.** The new user signs in with the email
  you invited — see [Signing in](/app/getting-started/signing-in).
* **Duplicates are rejected.** If someone with that email is already a member
  of your company, you'll get an error instead of a second account. To change
  an existing member's access, [change their role](#change-a-users-role)
  instead.
* **Re-adding works.** A user you previously removed — or a user who belongs to
  a different company on the platform — can be invited again with the same
  email. They keep their existing sign-in and get access to your company with
  the role you chose.
* **A failed email isn't a failed invite.** If the invite email couldn't be
  sent, the user is still added — you'll see a warning instead of a success
  message, and you can [resend the invite](#resend-an-invite) from their row.

## The role catalog

A user's role decides everything they can see and do. Roles are predefined —
you pick from the catalog rather than composing permissions by hand. The
dropdown shows each role's description, summarized here:

| Role                                | What it allows                                                                                                                                                                                                            |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Carrier Admin**                   | Full read/write access to all company data. The only standard role that can **manage users** (invite, change roles, remove), edit **company settings**, manage **API keys**, and import/export company **configuration**. |
| **Manager**                         | Full read/write access to all company data — submissions, quotes, policies, claims, exposures, forms, financials. Cannot manage users, company settings, or API keys.                                                     |
| **Policy Administrator**            | Full access to create and edit submissions, quotes, policies, exposures, and forms, and can edit company settings and manage API keys — but **no access to claims or incidents**.                                         |
| **Event Manager**                   | Full read/write access to claims and incidents (events), plus quoting and policy work; read/export access on everything else.                                                                                             |
| **MGA**                             | Full read/write access to incidents; read and export access on everything else.                                                                                                                                           |
| **UW/Ops Team Member**              | Full read/write access to all company data, **except** write access to forms and form templates.                                                                                                                          |
| **Accounts Payable**                | Read and export access to all company data; write access to financial transactions only.                                                                                                                                  |
| **Captive Manager**                 | Read and export access to all company data; write access to company-level files only.                                                                                                                                     |
| **Viewer**                          | Read-only access to all company data.                                                                                                                                                                                     |
| **Viewer/Exporter**                 | Read access to all company data, plus downloading files and exporting data.                                                                                                                                               |
| **Viewer/Exporter - Insured Forms** | Read and export access to all company data, plus the ability to work with insured forms.                                                                                                                                  |
| **Client Member**                   | Read and download access to company files only.                                                                                                                                                                           |
| **Configuration Manager**           | Export and import company configuration and upload raters — nothing else. Useful for a key that only manages [how your app is configured](/app/getting-started/configuration).                                            |
| **Super Admin**                     | Every permission in the catalog, including configuration import/export. Assignment is normally reserved for AI Insurance staff working with you.                                                                          |

<Note>
  You may also see a **Support Engineer** role in your users list from time to
  time — it's an internal AI Insurance role used by our staff when helping with
  a support request, and it **cannot be assigned** through the invite or
  change-role flows.
</Note>

Throughout the app, what a user's role doesn't allow simply doesn't appear:
buttons, menu items, and whole admin tabs are hidden rather than disabled, so
a Viewer never sees an Edit button they can't use.

## Change a user's role

Each row's **Role** column is an inline dropdown. Pick a new role and the
change applies immediately — you'll see a confirmation like *"Updated
\<name> to role: Manager"*, and the user's access changes the next time
their pages load.

<Frame caption="The role dropdown lists every assignable role with its description.">
  <img src="https://mintcdn.com/ai-insurance-fmv1/XH5fzBvkqbS_uBK9/assets/app/admin/role-picker.png?fit=max&auto=format&n=XH5fzBvkqbS_uBK9&q=85&s=8adf09d9b26659e12be2506d57c607a9" alt="A user row with the Role dropdown expanded, listing roles such as Carrier Admin, Manager, and Viewer, each with a short description underneath its name." width="2028" height="1600" data-path="assets/app/admin/role-picker.png" />
</Frame>

Two guardrails apply:

* **You can't change your own role.** Your own row's dropdown is disabled; ask
  another admin.
* **You can't demote the last admin.** If the user is the only Carrier Admin in
  your company, moving them to another role is rejected — assign another
  Carrier Admin first. This keeps you from locking everyone out of user
  management.

## Resend an invite

The **send** icon in a user's Actions column re-sends the invite email — useful
when someone lost the original message or it never arrived. Confirm the
recipient in the dialog and select **Confirm**; you'll see *"Successfully sent
new invite to \<email>"*.

## Remove a user

The **trash** icon in a user's Actions column revokes their access to your
company. The **Remove User** dialog confirms what removal means — once removed,
the person can no longer access your company's AI Insurance instance — and
offers a **Send email notification to user** checkbox (checked by default) so
they're told their access was revoked.

<Frame caption="Removing a user revokes their access; a notification email is optional.">
  <img src="https://mintcdn.com/ai-insurance-fmv1/XH5fzBvkqbS_uBK9/assets/app/admin/remove-user-dialog.png?fit=max&auto=format&n=XH5fzBvkqbS_uBK9&q=85&s=e481f71682d274a3a07bff3074f9a014" alt="The Remove User dialog explaining that the user will no longer be able to access the company's AI Insurance instance, with a checked 'Send email notification to user' checkbox and Remove User / Cancel buttons." width="1354" height="574" data-path="assets/app/admin/remove-user-dialog.png" />
</Frame>

Removal is how you deactivate someone — there is no separate "deactivate"
switch. It only revokes their access to **your** company; records they created
(notes, files, tasks) are unaffected, and you can [invite them
back](#invite-a-user) later with the same email address.
