> ## Documentation Index
> Fetch the complete documentation index at: https://reseller-docs.wamatrix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding a Tenant

> Create tenants from the panel or let them register themselves.

<Warning>
  Set up [**registration and email**](#registration-verification-settings), [**bot protection**](#bot-protection), and [**social login**](#social-login) before tenants start registering. These settings apply only to new registrations and do not affect existing tenants.
</Warning>

## Registration & Verification Settings

Go to **Settings → Tenant Settings**.

<Frame caption="The Tenant Settings page, with the registration toggles and the tenant plan limit alert">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/tenant-settings.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=d02cf91998abcb104e543f25e7ca3ae4" alt="The Tenant Settings page, with the registration toggles and the tenant plan limit alert" width="1639" height="515" data-path="images/pa/tenant-settings.png" />
</Frame>

### Allow tenant registration

**Enable Registration** lets tenants create their own accounts. It is **enabled by default**.

When disabled, new registrations are closed, but existing tenants can continue using their accounts.

### Verification and emails

These settings are **off by default**:

| Setting                               | What it does                                                                                                                      |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Enable Email Verification**         | Requires tenants to verify their email before signing in. Verification links are valid for 60 minutes and can be sent again.      |
| **Enable Registration Success Email** | Sends a confirmation email after registration.                                                                                    |
| **Enable Send Welcome Mail**          | Sends a welcome email with the tenant's plan and dashboard link. If email verification is enabled, it is sent after verification. |

<Note>
  Only self-registered tenants need email verification. Tenants added from the panel and those signing in with Google or Facebook are already verified.

  SMTP must be configured before verification emails can be sent.
</Note>

## Tenant Plan Limit Alerts

**Tenant Near Plan Limit** sends an email when a tenant reaches the selected usage threshold. It is **off by default**.

The default threshold is **80%** and can be set from **50%–99%**.

<Note>
  This alert is sent to the tenant.

  To receive alerts for the reseller's own plan, enable **Plan Limit Almost Reached** under **Settings → Admin Notifications**. These are separate settings.
</Note>

## Bot Protection

Go to **Settings → Re-Captcha** to protect login, password recovery, and tenant registration from bots.

<Frame caption="The Bot Protection page, with the reCAPTCHA and Turnstile provider options and their key fields">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/bot-protection.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=3f783b945e8ab7ee0625de1e0056e7d3" alt="The Bot Protection page, with the reCAPTCHA and Turnstile provider options and their key fields" width="1636" height="496" data-path="images/pa/bot-protection.png" />
</Frame>

| Provider                 | Required keys                                               |
| ------------------------ | ----------------------------------------------------------- |
| **Google reCAPTCHA v3**  | Requires a **Site Key** and **Secret Key** from Google.     |
| **Cloudflare Turnstile** | Requires a **Site Key** and **Secret Key** from Cloudflare. |

Only one provider can be active at a time. Bot protection is **off by default**.

<Warning>
  Incorrect keys can prevent tenants from logging in, not just from registering. Make sure the keys match the selected provider before enabling bot protection.
</Warning>

## Social Login

Go to **Settings → Social Auth** to let tenants and reseller staff sign in with **Google** or **Facebook**. Both providers are **off by default**.

<Frame caption="The Social Login Settings page, with the Google and Facebook credential and redirect URI fields">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/social-login.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=55d0b443542e0ea23f783a1ba5fd19ba" alt="The Social Login Settings page, with the Google and Facebook credential and redirect URI fields" width="1622" height="695" data-path="images/pa/social-login.png" />
</Frame>

<Tabs>
  <Tab title="Google">
    **Required credentials:** Client ID and Client Secret.

    Add the redirect URL shown on this page to your Google developer console as the **Authorized Redirect URI**.
  </Tab>

  <Tab title="Facebook">
    **Required credentials:** App ID and App Secret.

    Add the redirect URL shown on this page to your Facebook developer console as the **Valid OAuth Redirect URI**.
  </Tab>
</Tabs>

A new tenant signing in with Google or Facebook for the first time gets an account created automatically.

<Info>
  Copy the redirect URL exactly as shown, including `https://`. If it does not match, social login will not work.
</Info>

## Adding a Tenant

<Tabs>
  <Tab title="From the panel">
    <Frame caption="The Add Tenant form, with the tenant, workspace, plan, and password fields">
      <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/add-tenant-form.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=fdda0516bfa6a4eede59852a7a0ab72c" alt="The Add Tenant form, with the tenant, workspace, plan, and password fields" width="661" height="615" data-path="images/pa/add-tenant-form.png" />
    </Frame>

    <Steps>
      <Step title="Open the Add Tenant form">
        Go to **Tenants** and click **Add Tenant**.
      </Step>

      <Step title="Enter the tenant details">
        | Field                                 | Description                                                                                                                    |
        | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
        | **Full name** and **Email**           | The tenant's name and email address.                                                                                           |
        | **Workspace**                         | The tenant's business or company name.                                                                                         |
        | **Tenant Name**                       | Used as the tenant's subdomain. Generated from the **Workspace** name using lowercase letters and numbers, and can be changed. |
        | **Phone**                             | The tenant's phone number. **Country** and **Address** are optional.                                                           |
        | **Plan**                              | Optional. Leave **Select a plan** if the plan will be assigned later.                                                          |
        | **Password** and **Confirm Password** | Set and confirm the tenant's password.                                                                                         |
      </Step>

      <Step title="Save">
        Click **Save**.
      </Step>
    </Steps>

    <Info>
      You must share the login details with the tenant separately.
    </Info>
  </Tab>

  <Tab title="Public registration">
    When **Enable Registration** is enabled, tenants can create their own accounts and choose a plan during registration.

    Their workspace is created automatically after registration.
  </Tab>
</Tabs>

## What the tenant sees

After signing in, tenants see the features and limits available on their plan. Features not included in the plan appear with a lock icon and an **Upgrade Plan** option.

<Tip>
  To view the tenant's experience, go to **Tenant List → Impersonate**. A **You are impersonating this tenant** banner appears while active. Select **Stop Impersonating** to return to the reseller account.
</Tip>