> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/user-manual/manual/system-setup/tenants/overview/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# Tenants

> **Full version: not available for Starter and Growth clients**
>
> If you want to get access to all IXOPAY platform features you need to upgrade your plan. Please contact our Support Team in the [IXOPAY Customer Experience Portal](https://ixopay.my.site.com/support) for more information.

## Sub-Tenant Configuration

Your company or organization is represented using tenants in the IXOPAY platform. You can structure your organization hierarchically using sub-tenants.

> **Tip**
>
> Please note that unlike other entities in the IXOPAY platform, (sub-)tenants cannot be archived.

## Adding a New Sub-Tenant

To add a new sub-tenant to your setup:

1. Click **+ New Tenant** in the tenants overview.
2. Enter the sub-tenant's **name, parent tenant, default currency** and **user password validity**.
3. Click **Create Tenant**.

The newly created sub-tenant is displayed in the tenants overview where it can be edited further.

![Tenants overview](https://documentation.ixopay.com/manual/assets/ideal-img/tenants-overview.3eb558f.1280.png)Tenants overview![Creating a sub-tenant](https://documentation.ixopay.com/manual/assets/ideal-img/creating-a-sub-tenant.442610a.782.png)Creating a sub-tenant

## Editing a Sub-Tenant

To edit a sub-tenant in your setup:

1. Click **Edit** in the tenants overview for the sub-tenant you want to edit.
2. Make the desired changes in the tenant settings and click **Save Tenant**.

Available sections are

**Tenant Data** :

* **Tenant name**
* **Parent tenant**
* **Default Currency**
* **Login Disabled**

**Settings** :

* **User password validity (months)**
* **Redirect From Merchant Login to Admin Login** (toggle on/off)
* **Mandatory merchant fields**
* **Default Layout (**[**Pay-By-Link**](https://documentation.ixopay.com/manual/docs/connector-specific-features/paybylink)**)**
* **Send Confirmation Mail to Customer (Pay-By-Link)** (toggle on/off)

[**Mail Settings**](https://documentation.ixopay.com/manual/docs/system-setup/tenants/mail-settings)

![Tenant settings](https://documentation.ixopay.com/manual/assets/ideal-img/tenant-settings.aa29669.1280.png) Tenant settings

> **Note**
>
> If you enable the **Login Disabled** option, all users are prevented from accessing the tenant and any merchants under this tenant. It does not prevent transactions from taking place.

Additional Tenant Editing Options

* [Roles](https://documentation.ixopay.com/manual/docs/system-setup/roles)
* [Users](https://documentation.ixopay.com/manual/docs/system-setup/user)
* [Job Schedule](https://documentation.ixopay.com/manual/docs/post-processing/jobs)
* [Contacts](https://documentation.ixopay.com/manual/docs/system-setup/service-contacts)

> **Note**
>
> Keep in mind that settings (e.g. **Mail Settings**) are inherited from the parent entity, unless they are overridden.