# Mail

How outgoing mail is built — sender identity, layout, signature, and special-purpose addresses.

Access these settings under **Administration > Configuration settings > Mail**. This category contains **18 settings**, listed below with the title and comment shipped in the platform's settings fixtures (`SettingsCurrentFixtures.php`).

> The variable name in code is shown in monospace. Use it when scripting via the API or when you need to change those settings at a global level by editing [`config/settings_override.yaml`](https://github.com/chamilo/chamilo-lms/wiki/Configurations#configsettings_overridesyaml).

## Settings

### `allow_email_editor_for_anonymous`

**E-mail editor for anonymous**

Allow anonymous users to send e-mails from the platform. In this day and age of information security this is not a recommended option.

*Default: `true`*

### `cron_notification_help_desk`

**E-mail addresses to send cronjobs execution reports**

Given as array of e-mail addresses. Does not work for all cronjobs yet.

### `mail_content_style`

**Extra e-mail HTML body attributes**

Extra HTML attributes to apply to the body tag of generated notification emails.

### `mail_header_style`

**Extra e-mail HTML header attributes**

Extra HTML attributes to apply to the header section of generated notification emails.

### `mailer_debug_enable`

**Mail: Debug**

Select whether you want to enable the e-mail sending debug logs. These will give you more information on what is happening when connecting to the mail service, but are not elegant and might break page design. Only use when there is not user activity.

*Default: `false`*

### `mailer_dkim`

**Mail: DKIM headers**

Enter a JSON array of your DKIM configuration settings (see example).

### `mailer_dsn`

**Mail DSN**

The DSN fully includes all parameters needed to connect to the mail service. You can learn more at <https://symfony.com/doc/6.4/mailer.html#using-built-in-transports>. Here are a few examples of supported DSN syntaxes: <https://symfony.com/doc/6.4/mailer.html#using-a-3rd-party-transport>

*Default: `null://null`*

### `mailer_exclude_json`

**Mail: Avoid using LD+JSON**

Some e-mail clients do not understand the descriptive LD+JSON format, showing it as a loose JSON string to the final user. If this is your case, you might want to set the variable below to 'false' to disable this header.

*Default: `false`*

### `mailer_from_email`

**Send all e-mails from this e-mail address**

Sets the default email address used in the "from" field of emails.

### `mailer_from_name`

**Send all e-mails as originating from this (organizational) name**

Sets the default display name used for sending platform emails. e.g. "Support team".

### `mailer_mails_charset`

**Mail: character set**

In case you need to define the charset to use when sending those e-mails. Leave empty if you're not sure.

*Default: `UTF-8`*

### `mailer_xoauth2`

**Mail: XOAuth2 options**

If you use some XOAuth2-based e-mail service, use this setting in JSON to save your specific configuration (see example) and select XOAuth2 in the mail service setting.

### `messages_hide_mail_content`

**Hide e-mail content to bring users to platform**

Prefer short e-mail versions with a link to the messaging space on the platform to increase platform-based engagement.

*Default: `false`*

### `notifications_extended_footer_message`

**Extended notifications footer**

Add a custom extra footer for notifications emails for a specific language, for example for privacy policy notices. Multiple languages and paragraphs can be added.

### `send_notification_score_in_percentage`

**Send score in percentage in test results notification**

Sends exercise scores as percentages instead of points in test result notification emails.

*Default: `false`*

### `send_two_inscription_confirmation_mail`

**Send 2 registration e-mails**

Send two separate e-mails on registration. One for the username, another one for the password.

*Default: `false`*

### `show_user_email_in_notification`

**Show sender's e-mail address in notifications**

Includes the sender's email address with their name in personal message and notification emails.

*Default: `false`*

### `update_users_email_to_dummy_except_admins`

**Update users e-mail to dummy value during imports**

During special CSV cron imports of users, automatically replace e-mails with dummy e-mail <username@example.com>.

*Default: `false`*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/administration-guide/admin-guide/platform-settings/mail-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.