diff --git a/spring-integration-reference/src/mail.xml b/spring-integration-reference/src/mail.xml
index c34d6ec93d..ea5cdc99dc 100644
--- a/spring-integration-reference/src/mail.xml
+++ b/spring-integration-reference/src/mail.xml
@@ -17,10 +17,11 @@
a MailMessage instance, it will be sent directly. Therefore, it is generally recommended to precede this
consumer with a Transformer for non-trivial MailMessage construction requirements. However, a few simple
Message mapping strategies are supported out-of-the-box. For example, if the message payload is a byte array,
- then that will be mapped to an attachment. If the payload is neither a MailMessage or byte array, then a
- MailMessage will be created with text content corresponding to the value returned from the Spring Integration
- Message payload's toString() method. For simple text-based emails, simply provide a
- String-based Message payload.
+ then that will be mapped to an attachment. For simple text-based emails, you can provide a String-based
+ Message payload. In that case, a MailMessage will be created with that String as the text content. If you
+ are working with a Message payload type whose toString() method returns appropriate mail text content, then
+ consider adding Spring Integration's ObjectToStringTransformer prior to the outbound
+ Mail adapter (see the example within for more detail).
The outbound MailMessage may also be configured with certain values from the