---
title: "Tenant settings"
slug: "tenant-settings"
tags: ["Totara Platform", "Reference", "Site Administrator"]
updated: 2025-07-22T10:52:18Z
published: 2025-07-22T11:18:16Z
canonical: "totara.help/tenant-settings"
---

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

# Tenant settings

When [creating](/19/docs/add-a-tenant) or [editing](/19/docs/edit-a-tenant) a tenant the following settings are available.

| **Setting** | **Description** | **Notes** |
| --- | --- | --- |
| Name | The name of the tenant. | Required field. |
| Tenant identifier | Tenant identifier must be unique, and include lower case letters (a-z) and numbers (0-9). No capital letters, spaces or special characters. The tenant identifier must start in a letter, e.g. t001. | Required field. The **Tenant identifier** will be used as part of the URL for tenant login pages if the **Enable pre-login tenant themes** setting is enabled. |
| Description | You can optionally add a description of the tenant. This may help others to understand how to use the tenant. | - |
| Suspended | Tick to suspend the tenant. | When a tenant is suspended the user status for all **Tenant members** will be changed to **Tenant Suspended**. Tenant members will not be able to log in to the site while their tenant is suspended. |
| Tenant category name | If you are using Totara Learn then a new course category will be created to contain all of the courses for your tenant. This field allows you to enter a name for the course category created for the tenant. If left blank then the tenant name will be used. | This only applies when using Totara Learn. As with other course categories in Totara Learn, you can create subcategories to the tenant course category. |
| Tenant users audience name | When creating a new tenant an audience will also be created containing all of the tenant users. This field allows you to choose a custom name for the tenant audience. If left blank then the tenant name will be used. | These audiences are created at the **category** level, not the system level, and therefore have limited actions available for them. You can find out more in the [Tenant audiences](/19/docs/what-is-multitenancy) section. |
| Tenant dashboard name | Give a name to the dashboard assigned to this tenant. If left blank then the tenant name will be used. | The dashboard name is visible to **Tenant members**. Global Site Administrators can change the tenant dashboard name at any point. |
| Clone dashboard | You can choose to clone any existing dashboard for use as the tenant dashboard. | Cannot be edited after creation. If you wish to create a new dashboard for the tenant then you will need to create a dashboard as usual, and then choose that one to be cloned when creating your 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-01T18%3A10%3A22Z&se=2026-11-01T19%3A10%3A22Z&sr=c&sp=r&sig=Uge2s2lgtgx8sTj4vKtPpxCK31TArXGb5VRgv2fb0uY%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.