---
title: "Upload users to a tenant"
slug: "upload-users-to-a-tenant"
tags: ["Totara Platform", "Explainer", "Site Administrator", "How-to"]
updated: 2026-08-13T16:00:58Z
published: 2026-08-13T16:00:58Z
canonical: "totara.help/upload-users-to-a-tenant"
---

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

# Upload users to a tenant

## **Upload users (Tenant User Manager)**

If you are a Tenant User Manager or Site Administrator then you will be able to bulk upload users to a tenant.

1. Go to *Quick-access menu > Tenants.*
2. Select the tenant to which you want to bulk add users.
3. From the **Administration** block go to *Tenant > Tenant users*.
4. Select the **Upload tenant members** button.
5. You can click **Download** next to **CSV file template** to download a template file to upload with your user data.
6. Select a file to upload and configure the settings (as described below).
7. If needed you can adjust the upload settings (**Encoding**, **Create password if needed and send via email** and **Force password** change).
8. You can also set a range of **User defaults** which can be used if information is not provided in the file you upload.
9. Click **Upload tenant members**.

If required you can click **Preview** to see how your uploaded data will look. After uploading your file, check the **Tenant users** page to see the users you have uploaded.

When using the tenant user upload method it is not possible to update the authentication method.

[Embedded content](https://www.youtube.com/embed/kyGa7F6n428?&wmode=opaque&rel=0)

## **Upload users (Site Administrator)**

Global Site Administrators can upload users to your Totara site in bulk using **Upload users**, which can be found by navigating to *Quick-access menu > Users > Upload users*. You can find out more about how to do this on the [Upload users](/totara-20/docs/upload-a-user) page.

When using this function with multiple tenants on your site, you can choose which tenant users are uploaded into using the **Tenant** dropdown list in the **Default values** section.

## Next steps

- [Assign the Tenant Domain Manager role](/totara-20/docs/assign-the-tenant-domain-manager-role)
- [Assign the Tenant User Manager role](/totara-20/docs/assign-the-tenant-user-manager-role)
- [Add existing users to a tenant](/totara-20/docs/add-existing-users-to-a-tenant)
- [Create new users in a tenant](/totara-20/docs/create-new-users-in-a-tenant)
- [Edit a tenant](/totara-20/docs/edit-a-tenant)

![Course badge](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/course-badge_multitenancy(1).svg?sv=2026-02-06&spr=https&st=2026-11-01T12%3A55%3A23Z&se=2026-11-01T13%3A55%3A23Z&sr=c&sp=r&sig=5zwAM0TAIjKyBU4IGNEaMAQFFDzd%2FhceoowSx%2FPJm1E%3D)The Totara Academy has a whole course dedicated to using [Multitenancy in Totara](https://totara.community/mod/page/view.php?id=22057). Here you can learn more on how to set up and use tenants, see best practice, and give it a go yourself.

Join the [Totara Community](https://totara.community/) for more resources to help you get the most out of Totara.

© Copyright 2026 Totara Learning Solutions. All rights reserved.