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.
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
Last updated
Was this helpful?