Appearance
Custom Webmail Branding on Your Own Domain
Put MXroute Webmail on a hostname you own, with your name, your logo, and your accent color. Your users go to an address like webmail.yourdomain.com, see your brand on the login screen and throughout the app, and never see ours. Setup is self-serve and takes about five minutes plus DNS propagation. There is no approval queue and no waiting for an email from us.
What you need
- An active MXroute account with a domain on it.
- A
postmaster@mailbox on that domain. Branding is managed by logging in aspostmaster@yourdomain.com, so if that mailbox does not exist yet, create it first. Any password you set works; you just need to be able to log in with it. - Access to your domain's DNS (wherever you add records: Cloudflare, Namecheap, GoDaddy, your registrar's panel).
- Optional: a logo image. PNG or JPEG, up to 1 MB, up to 4096 pixels on either side. It will be shown on a white login card, so transparent or white backgrounds work best.
Step 1: Log in as postmaster
Go to https://webmail.mxroute.com and sign in as postmaster@yourdomain.com with that mailbox's password.
Open the account menu (your initial, top right), choose Settings, then Branding in the left navigation. The Branding section only appears for postmaster logins; regular mailboxes do not see it.
Step 2: Brand
The first card asks for your brand:
- Name: what the product is called for your users (up to 48 characters). Shows on the login screen, the browser tab, and the installable app.
- Logo: optional upload. If you provide one, it replaces the name as the visual mark. It also becomes the favicon and the app icon.
- Accent color: optional. Buttons and highlights follow it. The app automatically adjusts shades so text stays readable in both light and dark themes.
- Support link: optional. A "Contact support" link for your users, either an
https://address or an email address. Point it at your own helpdesk so your users contact you, not us.
Step 3: Choose your web address
Enter the hostname your users will visit, for example webmail.yourdomain.com or mail.yourdomain.com. It has to be under your own domain, the same one your postmaster login belongs to.
Step 4: Add the DNS record
The page shows you the exact record to create. At your DNS host, add it as shown:
| Type | Host | Target |
|---|---|---|
| CNAME | webmail | webmail-connect.mxroute.com |
The Host field is the part before your domain (most DNS panels want webmail, not webmail.yourdomain.com). The target is always webmail-connect.mxroute.com.
Using Cloudflare? Set the record to DNS only (the gray cloud, not the orange one). The Cloudflare proxy hides your CNAME and verification will fail until it is off.
Step 5: Go live
Back on the Branding page, the last card checks your DNS. It re-checks on its own, or you can press Check now. DNS changes usually land within minutes but can take up to an hour, so a "No DNS record found yet" message right after you saved the record just means it has not propagated.
When the check passes you will see: Verified. Your webmail is live at https://webmail.yourdomain.com.
The HTTPS certificate is issued automatically the first time the address is visited. Nothing to configure, nothing to renew.
After setup
- Your users sign in at your address with their full email address and mailbox password, exactly like before. Nothing about their accounts changes.
- The branding follows them through the whole app, including the installable mobile app (PWA).
- You can change the name, logo, color, or support link any time from the same page. Changes are live immediately.
- Removing the branding is one button on the same page. After removal your hostname shows the standard MXroute client until its certificate lapses, then stops working; also delete the CNAME at your DNS host.
Troubleshooting
The Go live card tells you what it actually sees, so start there:
- "No DNS record found yet": the record has not propagated, or the Host field was entered wrong (a common one: entering
webmail.yourdomain.comin a panel that wanted justwebmail, which createswebmail.yourdomain.com.yourdomain.com). - "Found a CNAME pointing to...": your record points somewhere other than
webmail-connect.mxroute.com. Edit it. - "This name currently points to [IP addresses]": either an old A record exists on that hostname (delete it, the CNAME is all you need), or Cloudflare's proxy is on. Set the record to DNS only (gray cloud).
If you are stuck after an hour, open a support ticket and include your domain and the hostname you chose. We can see the same checks from our side.
Coming from Crossbox branding?
This replaces the old Crossbox branding setup. The new webmail is branded per domain by the postmaster login, the CNAME target is webmail-connect.mxroute.com (not mail.mxlogin.com), and there is no processing wait: verification and the certificate are automatic. Your existing Crossbox branding keeps working on Crossbox; this article covers the new webmail only.