> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/notifications/customize-email-templates.md).

# Customize email templates

{% embed url="<https://dollarlabs.neetorecord.com/watch/8f82b1c37bf2df06219d>" %}

*This article's section starts at 1:19 in the video.*

Every DollarBack email can be rebranded to match your store (logo, colors, layout, copy, and subject line) in a visual drag-and-drop editor. When you're done, you'll have on-brand emails that pull in each customer's real amounts and dates through variables.

## Prerequisites

* Know which template you're editing and when it fires; see [Email notifications overview](/dollarback-store-credit/notifications/email-notifications-overview.md).

## Step 1: Open the template editor

1. Go to **DollarBack admin → Notifications**.
2. In the **Email Templates** section, click **Edit** on the template you want to change.
3. The editor opens with the current design loaded.

## Step 2: Edit the subject

The **Subject** field sits above the body editor. It accepts the same variables as the body, so a subject like `{firstName}, you just earned {formattedAmount}!` renders personalized for every recipient.

## Step 3: Design the body

The body is built from drag-and-drop blocks: logo, banner image, text, buttons, footer. Drag blocks in from the sidebar, click any block to edit its content and styling, and reorder or delete blocks directly on the canvas. Your design is saved as a layout and rendered to HTML at send time, so it stays editable. You never have to touch raw HTML.

Type variables directly into any text region; they're replaced with the customer's real values when the email sends.

## Variables you can use

### Universal variables (all templates, subject and body)

| Variable            | Renders as                                        |
| ------------------- | ------------------------------------------------- |
| `{firstName}`       | Customer's first name                             |
| `{lastName}`        | Customer's last name                              |
| `{amount}`          | The credit or reward amount as a plain number     |
| `{formattedAmount}` | The amount with currency formatting (e.g. $10.00) |
| `{symbol}`          | The currency symbol (e.g. $)                      |
| `{currency}`        | The currency code (e.g. USD)                      |
| `{unsubscribeUrl}`  | The customer's unsubscribe link                   |

### Template-specific variables

| Template                     | Extra variables                                                       |
| ---------------------------- | --------------------------------------------------------------------- |
| Store Credit Credited        | `{balance}`, `{formattedBalance}`, `{expiresAt}`, `{remainingDays}`   |
| Store Credit Redeemed        | `{balance}`, `{formattedBalance}`                                     |
| Referral Reward Credited     | `{refereeFirstName}`, `{refereeLastName}`, `{balance}`, `{expiresAt}` |
| Store Credit Expiry Reminder | `{expiresAt}`, `{remainingDays}`                                      |
| Discount Code Earned         | `{discountCode}`, `{rewardSummary}`                                   |

{% hint style="warning" %}
Variables only resolve in the template they belong to. Putting `{discountCode}` in the credited email, for example, won't produce a code. Check the table above before reusing content across templates.
{% endhint %}

## Step 4: Send a test

1. Click **Send Test Mail** in the editor.
2. In the **Send Test Email** dialog, enter any address in **Test Email Address** and click **Send**.
3. The current draft is delivered with mock data filled in (the customer renders as "John Doe", amounts as $10.00, and the order as TEST-ORDER-12345), so you can check layout and variable placement without triggering a real event.

## Step 5: Save

Click **Save** to publish your changes. From that moment, every email of this type uses the new design.

## Verify it works

Trigger the real email once: place a small test order that earns cashback (for the credited template) and confirm the received email matches your design with real values in place of the variables.

## Common issues

* The test email never arrives: check spam, and see [Emails aren't arriving](/dollarback-store-credit/troubleshooting-and-faq/emails-arent-arriving.md).
* A variable shows up as literal text like `{expiresAt}`: the credit that triggered the email may have no expiry date, or the variable isn't supported in that template.
* The email looks different in a customer's inbox than in the editor: send a test to that mail provider; some clients render backgrounds and spacing differently.

## Related articles

* [Email notifications overview](/dollarback-store-credit/notifications/email-notifications-overview.md)
* [Sender identity and custom domain](/dollarback-store-credit/notifications/sender-identity-and-custom-domain.md)
* [Reward discount codes instead of store credit](/dollarback-store-credit/earning-cashback-programs/reward-discount-codes-instead-of-store-credit.md)
* [Emails aren't arriving](/dollarback-store-credit/troubleshooting-and-faq/emails-arent-arriving.md)