> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-en/productos/remote-desktop/how-to/how-to-bulk-upload-users.md).

# How to Perform a Bulk User Import in Remote Desktop

Import several users at once with a CSV file and then assign them to the environment with the management wizard.

When you need to register several accounts at once, bulk upload saves you from creating them one by one: you prepare a CSV file with the users, import it, and then complete their assignment and configuration in the environment.

> #### 👍 What you get
>
> Several users registered in the Remote Desktop environment from a single CSV, ready to be assigned with the management wizard.

### Before you begin

* Access the administration panel at [admin.plenit.com](https://admin.plenit.com) with permissions on the environment.
* Have an active Remote Desktop subscription. If you don't have one yet, set it up with the [Remote Desktop Quick Start.](https://docs.plenit.com/docs-en/productos/remote-desktop/quickstart.md)

In [admin.plenit.com](https://admin.plenit.com), go to **Cloud Services → Remote Desktop** and enter the environment subscription. In the section **Users**, at the top right, click **Import Users**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-a2513faf1ea6f191258e14cc154a62aee6cb2e60%2FCAPTURA%201%20%C2%B7%20secci%C3%B3n%20Users%20%C2%B7%20resaltar%20el%20bot%C3%B3n%20Import%20Users.jpg?alt=media" alt="Botón Import Users en la sección Users"><figcaption><p>Import Users button in the Users section</p></figcaption></figure>

> #### 📘 Also from the organization
>
> You can reach the same subscription from the organization, in **Subscriptions**. Use whichever route is more convenient for you; the rest of the process is identical.

To register a single user or modify an existing one, you do not need bulk upload: you do it from manual user management.

### Step 2. Download and fill in the CSV template

In the window for **Import Users**, click **Download this file** to download the template `bulk_import_users.csv`. The window does not close after downloading, so you can leave it open while you prepare the file (it only closes if you click outside it).

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-ebd3a6a0e142f03d82053abdc223b6c824707031%2FCAPTURA%202%20%C2%B7%20ventana%20Import%20Users%20%C2%B7%20resaltar%20Download%20this%20file.jpg?alt=media" alt="Descarga de la plantilla CSV"><figcaption><p>CSV template download</p></figcaption></figure>

#### 2.1 The file fields

Treat the file as a **comma-separated CSV**. Each line is a new user, with these fields:

* **Name**: user's first name.
* **LastName**: user's last name.
* **Email**: user's email address.
* **2FA**: whether two-factor authentication will be enabled. Optional.
* **Position**: job title. Optional.
* **Phone**: phone number. Optional.

#### 2.2 How each line is written

For a user `David Hasselhoff`, with email `dhasselhoff@plenit.com`, 2FA enabled, position `Marketing` and phone `888888888`, the line is:

```
David,Hasselhoff,dhasselhoff@plenit.com,True,Marketing,888888888
```

> #### 🚧 Keep the commas for empty fields
>
> If you leave an optional field empty, keep its comma so the CSV maintains its structure. For example, with only the required data and the phone number, the line looks like this: `David,Hasselhoff,dhasselhoff@plenit.com,,,888888888`.

### Step 3. Upload the file and import it

Back in the window **Import Users**, click **Upload Files**, select your CSV and open it. If the format is correct, you'll see a green indicator next to the file name; if there is a problem, it will be shown in red. With the green indicator, click **Import users**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-f9814486a1eaf01657b88c6ae99dc1cba35e30b2%2FCAPTURA%203%20%C2%B7%20validaci%C3%B3n%20del%20CSV%20en%20verde%20%C2%B7%20resaltar%20Import%20users.jpg?alt=media" alt="Validación del CSV e importación"><figcaption><p>CSV validation and import</p></figcaption></figure>

When finished, the platform offers two paths:

* **Add to subscription**: adds the users to the subscription right away.
* **Not now**: postpones the assignment so you can do it later.

If you choose **Add to subscription**, you go straight to server and user configuration (Step 5). If you choose **Not now**, continue with Step 4 to assign them whenever you want.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-80ffe76708dac1c936f55703781393cbbeb909fc%2FCAPTURA%204%20%C2%B7%20elecci%C3%B3n%20Add%20to%20subscription%20-%20Not%20now.jpg?alt=media" alt="Elección de cuándo asignar los usuarios"><figcaption><p>Choosing when to assign users</p></figcaption></figure>

Step 4. Open the assignment wizard

If you chose **Not now**, you go back to **Users**. Click **Manage users** to open the wizard **User Management**.

Select the **server** you are going to assign the users to and click **Next**. Then, select the **users** to whom you will apply the same configuration and click **Next**. You can use the search or create new ones with **New User**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-ad372f85447d31c211d89f15838ffc418e71e8ea%2FCAPTURA%205%20%C2%B7%20User%20Management%20%C2%B7%20selecci%C3%B3n%20de%20servidor%20y%20usuarios.jpg?alt=media" alt="Asistente User Management: servidor y usuarios"><figcaption><p>User Management wizard: server and users</p></figcaption></figure>

> #### 📘 Same configuration per server
>
> The wizard applies the same configuration to the group of users you select. If you need to configure them on multiple servers, repeat the process on each one.
>
> To link users to an existing domain, follow [How to associate a Remote Desktop user with a domain user.](https://docs.plenit.com/docs-en/productos/remote-desktop/how-to/how-to-associate-an-rd-user-with-a-domain-user.md)

### Step 5. Define access, user type, and security

Set how the selected users will access the environment:

* **Remote App**: the user only sees the application launchers.
* **Virtual Desktop**: the user accesses a full desktop.

Then choose the user type, **User** (standard) or **Administrator** (with administrator privileges). In **Type of user** you define whether they belong to a domain or are a leftover user; if you do not check the domain option, the user is created locally and is deleted if the server they are linked to is deleted. In **Security** you can enable **two-factor authentication**. When you're done, click **Next**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-823c46a6cc8a732c66a0cbc6b339ae435e369bef%2FCAPTURA%206%20%C2%B7%20opciones%20de%20acceso%2C%20tipo%20de%20usuario%20y%20seguridad.jpg?alt=media" alt="Configuración de acceso, tipo y seguridad"><figcaption><p>Access, type, and security configuration</p></figcaption></figure>

### Step 6. Assign applications and confirm

Select the applications the chosen users will have by clicking each one, and click **Save**. In the **Summary**, review all changes and, when they are correct, click **Confirm Changes**.

<figure><img src="https://3894148717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-56eb4ee59330fa3b346b970667ba31e7607f927f%2FCAPTURA%207%20%C2%B7%20asignaci%C3%B3n%20de%20aplicaciones%20y%20Summary%20con%20Confirm%20Changes.jpg?alt=media" alt="Asignación de aplicaciones y confirmación"><figcaption><p>Application assignment and confirmation</p></figcaption></figure>

If everything went well, the new users appear as registered in the Remote Desktop subscription.

### Conclusion

Mass upload solves the registration of many accounts in two stages: first you import the CSV with each user's data, and then you assign and configure them with the wizard.

The part the process cares about most is the file: respect the commas for empty fields and check that validation turns green before importing.

From there, the wizard lets you apply access, permissions, security, and applications to the group all at once. For individual registrations or to link users to a domain, continue with manual user management.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-en/productos/remote-desktop/how-to/how-to-bulk-upload-users.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
