> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-metadata.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Email
> Configure the SMTP server OpenMetadata uses to send invite, notification, and alert emails, and verify it with a test message.
# Email
OpenMetadata sends email for several purposes:
* Team invites
* Task and conversation notifications
* Alerts
* Scheduled reports
None of that mail goes out until an admin points OpenMetadata at a working SMTP server, so this is one of the first settings to configure on a new instance if you want invited teammates to actually receive their invite emails. The **Email** page under Preferences configures the SMTP server used to send all of these.
## Configure Email
1. Navigate to **Settings** > **Preferences** > **Email**.
2. Click **Edit**.
3. Configure the following fields:
| Field | Description |
| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Username** | SMTP account username |
| **Password** | SMTP account password |
| **Sender Email** | Required. The "from" address on outgoing mail. Can be the same as **Username**, though some providers, such as Amazon SES, use a different value for each |
| **Server Endpoint** | Required. Hostname of the SMTP server, for example `smtp.gmail.com` |
| **Server Port** | Required. Port the SMTP server listens on. The port you use determines which **Transportation Strategy** to select below |
| **Emailing Entity** | Name shown as the sender in outgoing emails, for example your organization name. Default: `OpenMetadata` |
| **Enable SMTP Server** | Turns SMTP sending on or off. When off, OpenMetadata doesn't send any email |
| **Support URL** | Link included in emails for users to reach your support team. Default: `https://slack.open-metadata.org` |
| **Transportation Strategy** | Connection security mode, chosen to match **Server Port** |
Match **Server Port** to the **Transportation Strategy** it corresponds to:
| Server Port | Transportation Strategy |
| :---------- | :---------------------- |
| `25` | `SMTP` |
| `465` | `SMTPS` |
| `587` | `SMTP_TLS` |
4. Click **Save**.
## Test Email
Use **Test Email** to verify the SMTP configuration works before relying on it for real notifications. This catches a wrong port, an expired password, or a blocked outbound connection immediately, instead of finding out later when an invite or an alert quietly fails to arrive:
1. From the Email settings page, click **Test Email**.
2. Enter a recipient address.
3. Click **Test** to send a one-off test message through the configured SMTP server.
A success or failure toast confirms whether the SMTP server accepted the test message.
## OpenMetadata URL
OpenMetadata URL is a separate, single-field setting stored alongside Email configuration. It's used to build the links inside the emails OpenMetadata sends — for example, the "view this asset" link in a task notification. If this points at the wrong address, every link in every notification email points at the wrong place, even though the emails themselves send successfully.
1. Navigate to **Settings** > **Preferences** > **OpenMetadata URL**.
2. Click **Edit**.
3. Set **OpenMetadata URL** to the base URL your users actually use to reach this instance. Default: `http://localhost:8585`, which only works for local development, so update it before you rely on email links in production.
4. Click **Save**.