Skip to content


This is where you'll see and manage the tenants of your workspace.

What is a tenant?

A tenant is a sub-division of your workspace. Each client and user is tied to a specific tenant.

This is mostly useful if you want to create a product sold in white-label where each of your client has its own space. It allows for example for a user to have several accounts with the same email address inside one workspace, but actually tied to different tenants. From a user point-of-view, this is a different application on which they login with different credentials.

If you don't plan to do this, that's okay: you'll always use a single tenant in your workspace.

Each workspace has at least one default tenant.

Tenants from admin dashboard

Base URL

Each tenant is tied to a base URL: each routes, like login or registration, will be derived from this base. When you integrate Fief in your application, you'll need this base URL.

Each workspace has one default tenant with a base URL pointing to your root subdomain, like

Other tenants gets a path prefix, like


You can copy the base URL directly using the clipboard button in the list.

Create a new tenant

You can create a new tenant by clicking the Create Tenant button. A modal will open where you'll be able to input:

The base URL is automatically generated from the name.

Optionally, you can also set:

  • A logo URL that will be shown on the top-left of authentication pages.
  • A UI theme to use when users authenticate with this tenant. If left empty, the theme set as default is used.
  • The list of OAuth Providers allowed to be used on this tenant.

Create tenant from admin dashboard

Edit an existing tenant

If you click on one of the tenant in the list, you'll see its details on the right.

View tenant details from admin dashboard

If you click on the Edit Tenant button, you'll be able to update its properties.

Edit tenant from admin dashboard

Disable user registration

You can choose to disable user registration on a tenant. To do this, you have to uncheck the Registration allowed checkbox in the tenant details.

When registration is disabled, users can't access the registration page and create a new account on this tenant.

Delete a tenant

If one your tenant is not useful anymore, you can delete it by clicking on it on the list and click on the Delete button on the right.

Delete tenant from admin dashboard

Users and clients will be removed as well

When you delete a tenant, all its associated users and clients will be deleted as well. The data won't be recoverable. Be sure of what you're doing!