How to Set a Custom Sender Alias in Spring Boot Email

In previous articles we covered the main scenarios for sending email with Spring Boot, such as basic sending, adding attachments, referencing static resources, and using templates.

When implementing the YouTube Chinese dubbing service, we discovered that recipients see the sender name as the email prefix (no‑reply) rather than the desired product alias (YouTube中文配音).

The MailProperties class does not provide a configuration option for an alias, so the alias must be set when constructing the mail message.

public class MailProperties {
    private static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8;
    private String host;
    private Integer port;
    private String username;
    private String password;
    private String protocol = "smtp";
    private Charset defaultEncoding = DEFAULT_CHARSET;
}

Example using SimpleMailMessage:

SimpleMailMessage message = new SimpleMailMessage();
message.setFrom("Programmer DD<[email protected]>"); // set sender alias
message.setTo("[email protected]");
message.setSubject("Subject: Simple Email");
message.setText("Test email content");
mailSender.send(message);

If you need to send more complex emails, you can use MimeMessage and set the alias in the same way with setFrom.