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

# Email Configuration

> Configure custom sender; default platform email fallback

Every org can configure a custom email sender so transactional emails (invites, reward notifications, achievement unlocks) appear to come from your brand domain. If not configured, Nudj falls back to a platform default sender.

## Configuring a custom sender

<Steps>
  <Step title="Open email settings" icon="envelope">
    Organisation Settings -> General -> **Email Configuration** (#1571).
  </Step>

  <Step title="Enter sender details" icon="pen">
    * **From name** — e.g. "Your Brand".
    * **From email** — e.g. `community@yourbrand.com`.
    * **Reply-to** — optional override.
  </Step>

  <Step title="Verify domain" icon="square-check">
    Nudj provides SPF / DKIM records for your DNS. Add them to your domain's DNS config, then click Verify.
  </Step>

  <Step title="Save" icon="save">
    All transactional emails now use your custom sender.
  </Step>
</Steps>

***

## Fallback behaviour

Orgs without custom email setup automatically use the Nudj platform default (#1671). This means:

* Members still receive emails reliably, even if you don't configure your own sender.
* You can delay custom sender setup without blocking the rest of your launch.
* Emails arrive from a Nudj domain until you're ready to brand.

***

## What emails use this

| Email                | Trigger                       |
| -------------------- | ----------------------------- |
| Welcome              | New member joins              |
| Team invite          | Admin invites a teammate      |
| Reward earned        | Member earns a reward         |
| Reward expiring      | Asset reward near expiry      |
| Achievement unlocked | Member unlocks an achievement |
| Streak reminder      | Member's streak at risk       |
| Giveaway winner      | Member wins a drawn giveaway  |

***

## DNS records

Nudj gives you three records to add:

* SPF (authorises Nudj to send on your behalf)
* DKIM (cryptographic signing)
* DMARC (policy enforcement — optional but recommended)

Email deliverability improves significantly with all three configured.

***

## Best practices

<Tip>
  Use a **subdomain** (`community.yourbrand.com`) rather than your primary domain for email sending. Protects your primary domain's reputation if something goes wrong with community emails.
</Tip>

<Tip>
  **Test before wide rollout** — invite yourself to your org using the custom sender, verify deliverability, check that it passes Gmail/Outlook filters.
</Tip>
