> For the complete documentation index, see [llms.txt](https://docs.primeur.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.primeur.com/panorama-2.0.1/setup-and-configuration/users-and-roles-setup/manage-users/create-a-new-local-user.md).

# Create a new local user

To create a new internal or external local user in Panorama:

1. Go to the **Users** section and click **New User**. The **New user** window appears.&#x20;

<figure><img src="/files/mOHiYUjZZTv34N99n29X" alt="" width="563"><figcaption></figcaption></figure>

2. By default, users are **Internal**. To create an **external user**, select the **External** button.

## User details

Fill in the following fields:

* **Username** (required): Unique login name. Only alphanumeric characters are supported.&#x20;
* **Password** (required): Login password. Minimum length: 8 characters.&#x20;
* **First Name / Last Name** (optional). If provided, these values appear in the chip at the top-right corner of Panorama. If left empty, the username is displayed instead.

<figure><img src="/files/jsxutCdQQpwZQmJwRR8n" alt="" width="563"><figcaption></figcaption></figure>

* **Email** (optional). If you want to use the option **“Notify me by email when the export is ready”** in **Export CSV**, this field must contain a valid email address. See the [Mail Sender](/panorama-2.0.1/setup-and-configuration/plugins-configuration/mail-sender.md) page for details about how to set up the email server.&#x20;

## Roles assignment (internal users only)

If the local user is internal, you can assign roles by clicking the **+** next to **Roles**.&#x20;

This speeds up user setup and ensures that permissions are assigned consistently across all users belonging to the same role.&#x20;

Roles must already exist. See the [Set Roles](/panorama-2.0.1/setup-and-configuration/users-and-roles-setup/set-roles.md) page.

When creating a new user, after assigning roles you must **save the user and reopen the user profile** to correctly display the permissions inherited from the assigned roles.&#x20;

When editing an existing user, if you assign a new or different role, the corresponding permissions are loaded immediately.

## Permissions (internal users only)

For internal local users, you can manage permissions in the **Permissions** panel.&#x20;

When creating a new internal user, **all available permissions are initially displayed**.&#x20;

If one or more roles are assigned, the permissions associated with those roles are **automatically enabled**. These role‑based permissions are visually identified by a **purple permission chip** and by an indication in brackets showing the role they originate from.

<figure><img src="/files/V4LMKcaQQMccWJc3AInJ" alt=""><figcaption></figcaption></figure>

Additional permissions can be enabled manually if required. Manually assigned permissions are displayed with an **orange permission chip**.

<figure><img src="/files/EbFje0vwde1dcUtaAKOw" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important**: Permissions inherited from roles are fully visible **only after saving the newly created user and reopening the user profile**.
{% endhint %}

The permissions list can be filtered by typing all or part of the permission name in the Search field. You can also limit the view to **assigned permissions only** by clicking the <img src="https://online-docs.gitbook.io/~gitbook/image?url=https%3A%2F%2Ffiles.readme.io%2F3ac0d8aad0ef374e956011d51d8eb1af8a1c4561486489becfc16e8084245bd5-image.png&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=a1fdc01c&#x26;sv=2" alt="" data-size="line"> eye icon. When the icon changes to a closed eye <img src="/files/MJI1Me42wHrNElqlHV8e" alt="" data-size="line"> only assigned permissions are shown. Click it again to display the full list of permissions.&#x20;

When finished, click  **Save** to confirm.&#x20;
