---
title: "Add existing users to a tenant"
slug: "add-existing-users-to-a-tenant"
tags: ["Site Administrator", "How-to", "Totara Platform", "Screenshot"]
updated: 2022-10-19T12:43:59Z
published: 2022-10-19T12:43:59Z
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](/17/docs/add-a-tenant) then you can either [create new users](/17/docs/create-new-users-in-a-tenant) in the tenant, or add existing users to your tenant. To add existing 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 participants*.
3. Select the **Non-member 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 **Non-member participants** column you can navigate away from the page, as there is no save button.

After adding users to a tenant you should use the quick-access menu to quickly return to the **Tenants** screen.

![Selecting existing users to add to the tenant.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1647856389702.png?sv=2026-02-06&spr=https&st=2026-11-10T18%3A11%3A33Z&se=2026-11-10T19%3A11%3A33Z&sr=c&sp=r&sig=9fGHoCS6ajbGu3TZig7LGAUmoGPSZ6JCNRbDB3fYQp0%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-10T18%3A11%3A33Z&se=2026-11-10T19%3A11%3A33Z&sr=c&sp=r&sig=9fGHoCS6ajbGu3TZig7LGAUmoGPSZ6JCNRbDB3fYQp0%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-10T18%3A11%3A33Z&se=2026-11-10T19%3A11%3A33Z&sr=c&sp=r&sig=9fGHoCS6ajbGu3TZig7LGAUmoGPSZ6JCNRbDB3fYQp0%3D)

## Next steps

- [Assign the Tenant Domain Manager role](/17/docs/assign-the-tenant-domain-manager-role)
- [Assign the Tenant User Manager role](/17/docs/assign-the-tenant-user-manager-role)
- [Create new users in a tenant](/17/docs/create-new-users-in-a-tenant)
- [Upload users to a tenant](/17/docs/upload-users-to-a-tenant)
- [Edit a tenant](/17/docs/edit-a-tenant)

![Course badge](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/course-badge_multitenancy.svg?sv=2026-02-06&spr=https&st=2026-11-10T18%3A11%3A33Z&se=2026-11-10T19%3A11%3A33Z&sr=c&sp=r&sig=9fGHoCS6ajbGu3TZig7LGAUmoGPSZ6JCNRbDB3fYQp0%3D)The Totara Academy has a whole course dedicated to using [Multitenancy in Totara](https://totara.community/course/view.php?id=558). 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.