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

# Email Marketing

> Send campaigns to your customers from a domain you own (Business plan)

Email Marketing is Komerza's built-in bulk email tool, in the dashboard sidebar under **Email Marketing** with pages for Overview, Campaigns, Templates, Recipients, Domains and Unsubscribed.

<Note>
  Email Marketing requires the **Business plan**. There is no application or
  approval step: upgrading unlocks it instantly, and downgrading locks it
  instantly. On the native mobile app the feature is hidden for non-Business
  accounts, so use the web dashboard.
</Note>

Team members need the **View Email Marketing** permission to see the pages and **Update Email Marketing** to change anything.

## Your monthly allowance

* Business includes **50,000 marketing emails per month per account**, shared across all your stores rather than per store.
* The allowance resets on your plan's billing anniversary. Unused emails do not roll over, and extra cannot be purchased.
* Only marketing campaigns consume it. Transactional customer emails - order and subscription emails - are unlimited and never count against it.

**Email Marketing → Overview** shows Emails Sent, Credits Remaining, Usage and your reset date. "Credits" simply means units of the monthly allowance; there are no credit packs to buy.

A campaign that would exceed your remaining allowance is refused up front: "Insufficient email quota. Need `{N}` but only `{M}` remaining this month."

## Verifying a sending domain

Campaigns must be sent from an address on a domain your store has verified.

<Steps>
  <Step title="Add the domain">
    **Email Marketing → Domains** → **Add Domain**.
  </Step>

  <Step title="Create the DNS records exactly as shown">
    The page lists **3 DKIM CNAME records**, **1 MX record** and **1 SPF TXT
    record** (both on `mail.<yourdomain>`), plus a recommended **DMARC TXT
    record**.
  </Step>

  <Step title="Wait for verification">
    Status updates automatically as DNS propagates, or press the check button. A
    domain shows **Verified** only once every check passes; until then it is
    **Pending**, with per-check guidance.
  </Step>
</Steps>

Both the From address and any Reply-To must use a verified domain, and verification is re-checked when a campaign actually sends.

<Warning>
  Domain names are unique across the platform, so "This domain is already
  registered." can mean another store claimed it - contact support if you own
  it. You also cannot delete a domain while campaigns using it are Sending or
  Scheduled.
</Warning>

## Templates and recipients

Design emails on **Templates** with the drag-and-drop editor, which has desktop, tablet and mobile previews, undo/redo and a code view.

<Tip>
  Upload images as assets (up to 5 MB each) rather than pasting them into the
  design. Embedded images are the usual cause of "This template is too large to
  save".
</Tip>

Personalise with lowercase merge tags:

```
{{first_name}}  {{last_name}}  {{email}}
{{store_name}}  {{store_url}}  {{unsubscribe_url}}
```

**Recipients** holds your lists. **All Customers** is the default list, auto-synced from customers who opted into marketing at checkout. It re-syncs before every send and cannot be deleted. You can also create custom lists and add recipients by email, deduplicated automatically. A campaign cannot be sent to an empty list.

## Campaigns

Create a campaign with a name, subject, preview text, From name, From email on a verified domain, an optional Reply-To, a template and a recipient list. It starts as **Draft**, and from there you can **Schedule** it (at least five minutes ahead) or **Send Now**.

<ResponseField name="Draft">Editable and not yet queued.</ResponseField>

<ResponseField name="Scheduled">
  Queued for a future time. Still cancellable.
</ResponseField>

<ResponseField name="Sending">
  In progress. **Cannot be cancelled from the dashboard.**
</ResponseField>

<ResponseField name="Sent">
  Finished. Note that a campaign which exhausts your allowance mid-send still
  shows Sent, so it can reach fewer people than the list size.
</ResponseField>

<ResponseField name="Under Review">
  Held by automated screening before sending. Only Komerza staff can release it.
</ResponseField>

<ResponseField name="Failed">
  The reason is not shown in the dashboard; support has to look it up.
</ResponseField>

At send time Komerza re-checks your plan, allowance, domain verification and list contents. Emails go out gradually in small batches to protect deliverability, so a large campaign can take hours and a long "Sending" state is normal.

Every campaign email automatically includes an unsubscribe footer and one-click unsubscribe support. You cannot remove it and do not need to add your own.

Per-campaign stats cover recipients, sent, delivered, opened, clicked, bounced and complaints.

## Suppressions

The **Unsubscribed** page (titled "Suppressions") lists addresses that will not receive your campaigns - unsubscribes, bounces and complaints, with type, reason and date. Suppressed addresses are skipped silently during sends, and suppression is per store.

<Warning>
  You can remove **Unsubscribe**-type entries only: "Only unsubscribe
  suppressions can be removed. Bounces and complaints are permanent." Sending to
  addresses that bounce or complain damages the deliverability of every campaign
  you send afterwards, which is why they are permanent.
</Warning>

## When to contact support

* "This domain is already registered." for a domain you own.
* A domain stuck **Pending** more than 48 to 72 hours after the DNS records are set exactly as shown.
* A campaign showing **Failed** or stuck **Under Review**.
* A "Sent" campaign where recipients report nothing arrived.
* A recipient reporting that an unsubscribe link does not work.
* A GDPR or data-erasure request from a recipient.