We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

Internationalized Domain Names (IDNs)

Article Preview

    Overview

    With Mailgun, it is possible to utilize IDN-based headers in an email message.  However, it is not possible to utilize IDN-based domains within the Mailgun environment.

    For full details on Internationalization and Mailgun, please visit our User Guide.

     

    Understanding the context

     

    Setting the scene

    Mailgun does support the use of Internationalized Domain Names (IDNs) in the messages themselves. For instance, internationalized email addresses in the To and From fields are fully supported in the Mailgun environment.  The same is true of subjects that contain UTF-8 characters. 

    Mailgun, however, does not support domains that consist of Punycode as well as Cyrillic and other non-ASCII alphabets. 

     

    Discerning the nuance

    There still are relatively few mailbox providers that fully support UTF8SMTP, without which IDNs cannot be supported. IDNs are a feature that requires both parties - the sending and receiving providers - to operate according to a common standard or protocol: UTF8SMTP, in this case. Until the time arrives that IDNs are more widespread, you may find the use of such domains problematic.

    Also of note is that while the Control Panel and Domains API may technically allow non-ASCII domains to be created, numerous Mailgun features such as Mailing Lists, Routes, and SMTP Credentials will not function correctly with non-ASCII domains.

     

    Implementing the solution

    To ensure a domain and all of its associated features operate as expected, please create a domain that utilizes only ASCII alphanumeric characters (a helpful chart of ASCII can be found here).   

     

    Need Support?

    Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support page of your Mailgun Control Panel, and we'll be with you shortly!