---
title: "Add existing users to a tenant"
slug: "add-existing-users-to-a-tenant"
tags: ["Totara Platform", "Site Administrator", "How-to", "Screenshot"]
updated: 2025-07-22T10:52:18Z
published: 2025-07-22T11:18:21Z
canonical: "totara.help/add-existing-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.

# Add existing users to a tenant

Once you have [created a tenant](/19/docs/add-a-tenant) then you can either [create new users](/19/docs/create-new-users-in-a-tenant) in the tenant, or add existing users to your tenant. To add existing site-level users to a tenant, follow these steps:

1. Go to *Quick-access menu > Tenants* and select the tenant to which you need to add users.
2. From the **Administration** block, go to *Tenant > Tenant users*.
3. Select the **Add tenant participants** button.
4. Browse or search to select the existing user(s) from the **Potential users** column.
5. With users selected, click the **Add** button.

Once all the users to be added are in the **Add tenant** **participants** column you can navigate away from the page, as there is no save button. Click **Back** to return to the **Tenant users** page.

![Selecting existing users to add to the tenant.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1694784848686.png?sv=2026-02-06&spr=https&st=2026-11-01T15%3A56%3A57Z&se=2026-11-01T16%3A56%3A57Z&sr=c&sp=r&sig=t9XUhD%2F8%2FDZ53s%2B2hrVc2ew9azPdOZMY95vP0AibpAA%3D)

## From the user profile

Alternatively you can add an individual user from their user profile. Follow these steps to assign an individual to a tenant:

1. Navigate to the user's profile.
2. In the **User details** block the **Tenant participant** section (or **Tenant member** depending on the user's tenant membership) will indicate whether the user is assigned to a tenant, and if so, which tenant.
3. Click the cog icon (![](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/cog.png?sv=2026-02-06&spr=https&st=2026-11-01T15%3A56%3A57Z&se=2026-11-01T16%3A56%3A57Z&sr=c&sp=r&sig=t9XUhD%2F8%2FDZ53s%2B2hrVc2ew9azPdOZMY95vP0AibpAA%3D)) under **Tenant participant** / **Tenant member**.
4. Either select a tenant from the **Tenant member** dropdown or select one or more tenants using the **Tenant participant** checkboxes.
5. Click **Save changes**.

The **User details** block will now show the user's updated tenant membership or participation.

![The User details block showing the user's tenant membership.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1647856500147.png?sv=2026-02-06&spr=https&st=2026-11-01T15%3A56%3A57Z&se=2026-11-01T16%3A56%3A57Z&sr=c&sp=r&sig=t9XUhD%2F8%2FDZ53s%2B2hrVc2ew9azPdOZMY95vP0AibpAA%3D)

## Next steps

- [Assign the Tenant Domain Manager role](/19/docs/assign-the-tenant-domain-manager-role)
- [Assign the Tenant User Manager role](/19/docs/assign-the-tenant-user-manager-role)
- [Create new users in a tenant](/19/docs/create-new-users-in-a-tenant)
- [Upload users to a tenant](/19/docs/upload-users-to-a-tenant)
- [Edit a tenant](/19/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-01T15%3A56%3A57Z&se=2026-11-01T16%3A56%3A57Z&sr=c&sp=r&sig=t9XUhD%2F8%2FDZ53s%2B2hrVc2ew9azPdOZMY95vP0AibpAA%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.