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

# Tenant Templates

> Learn how to use tenant components and variables in your notification templates.

## Overview

Use tenant properties in templates to dynamically render tenant-specific content. One template works for all tenants—SuprSend replaces variables with tenant-specific values at runtime.

## Email Template Design

Tenant variables in other channels are referred as `$brand.<property>` in templates. For email template designer, you get pre-built tenant component to automatically get the branded header, footer, and buttons for a tenant.

<Steps>
  <Step title="Find and add tenant component">
    Inside email template designer, find tenant component in the right side content menu and add it to your template.

    <Frame caption="Find and add tenant component in template editor">
      <img src="https://mintcdn.com/suprsend/V50oZ72sb-S4PKNh/images/tenant.png?fit=max&auto=format&n=V50oZ72sb-S4PKNh&q=85&s=15981ee343b7fdb5bff148c010f7f6df" alt="" width="700" height="654" data-path="images/tenant.png" />
    </Frame>
  </Step>

  <Step title="Select relevant block type">
    Select relevant block type (header, footer, buttons) from the right panel.

    <Frame caption="Select relevant block type">
      <img src="https://mintcdn.com/suprsend/V50oZ72sb-S4PKNh/images/tenant-block-types.png?fit=max&auto=format&n=V50oZ72sb-S4PKNh&q=85&s=d40603aba62bf95efbd0e393cf04a528" alt="" width="704" height="876" data-path="images/tenant-block-types.png" />
    </Frame>
  </Step>

  <Step title="Customize the selected block">
    Tenant blocks use the tenant's primary color and logo by default. Click any block to customize colors, padding, and styling from the right panel. To insert tenant variables anywhere in a block, use `{{$brand.<property>}}`. See the full list of [available variables](/docs/tenant-templates#available-variables).
  </Step>
</Steps>

## Customizing other channels templates

You can customize other channels using tenant variables as `{{$brand.<property>}}` in the template.

## Available Variables

Use `{{$brand.<property>}}` in handlebars templates and `data["$brand"].<property>` in JSONNET templates. Variables are replaced at runtime with the tenant’s properties (from the `tenant_id` passed when sending).

**Basic**

| Variable             | Description                       |
| -------------------- | --------------------------------- |
| `$brand.tenant_id`   | Tenant identifier (max 64 chars). |
| `$brand.tenant_name` | Display name for the tenant.      |
| `$brand.logo`        | URL of the tenant’s logo image.   |

**Colors**

| Variable                 | Description                  |
| ------------------------ | ---------------------------- |
| `$brand.primary_color`   | Primary brand color (hex).   |
| `$brand.secondary_color` | Secondary brand color (hex). |
| `$brand.tertiary_color`  | Tertiary brand color (hex).  |

**Social links**

| Variable                        | Description                   |
| ------------------------------- | ----------------------------- |
| `$brand.social_links.website`   | Website URL.                  |
| `$brand.social_links.facebook`  | Facebook profile or page URL. |
| `$brand.social_links.twitter`   | Twitter/X profile URL.        |
| `$brand.social_links.instagram` | Instagram profile URL.        |

**Custom properties**

| Variable                  | Description                                                                     |
| ------------------------- | ------------------------------------------------------------------------------- |
| `$brand.properties.<key>` | Any custom property set on the tenant (e.g. `$brand.properties.support_email`). |