# Mail

https://docs.wisecp.com/uk/mail-modules

Select the mail delivery module used by the application, so transactional messages leave the system through the provider you have configured.

## Reaching the Screen

Go to **Settings → Mail**: `{admin}/modules/mail`

## What Is on the Screen

The **Initial** tab selects one default mail module. **All Modules** lists the installed mail integrations and opens provider-specific settings.

## Fields

- **Enabled Module Selection**: The mail module used for outgoing application messages. Choosing none disables module-based delivery.

## Tasks

### Select the default mail module

1. Configure the intended provider from its card under **All Modules**.
2. Return to the **Initial** tab and select that provider as the default module.
3. Save. New outgoing mail uses the selected module when its provider configuration is valid.

### Change the delivery provider

1. Configure and test the replacement module.
2. Select it under **Default Module** and save.
3. Subsequent mail is routed through the replacement provider.

## Things to Watch

> **Configure before switching**
> 
> Selecting a module does not create its provider credentials. Complete and test the module configuration first to avoid interrupted delivery.

> **Standard SMTP authentication method**
> 
> Automatic lets the server pick the method and tries CRAM-MD5 first. Some providers, Postal for example, expect a different username for CRAM-MD5 than for PLAIN or LOGIN. Pick the method your provider documents; the connection test names the method it used.

> **When a setting cannot be saved**
> 
> If saving reports that a file cannot be written, the save did not complete. The file named in the message, or its folder, belongs to another user. When scheduled tasks run as root, that user is often root. Make them owned by the user your site runs as, then save again. Your hosting provider can do this for you. [Scheduled Tasks Setup](https://docs.wisecp.com/en/scheduled-tasks-setup) explains how to run the cron job as that user.

## Privileges

**Mail Module Settings** (`MODULES_MAIL_SETTINGS`) is required.

## Related Screens

- [Module Management](https://docs.wisecp.com/en/module-management)
- [Email Piping](https://docs.wisecp.com/en/email-piping)
