Give customers an address to write to, or forward the support address you already have. Replies go back by email.
Each organization can turn on one support address, <slug>.support@median.sh.
Mail to it opens a conversation in the inbox and the agent
answers it.
Turn on email support
Open the page
Go to Integrations → Email. Only admins and owners see the button. See Roles.
Turn it on
Select Turn on email support. The text beside it names the address it will issue.
Copy the address
Support email address shows the address with a copy button.
| Fact | Detail |
|---|---|
| Address | <slug>.support@median.sh. An organization with the slug acme gets acme.support@median.sh |
| When it is fixed | The first time email support is turned on. Changing the slug later does not change the address |
| Switch | Email support, in the Inbox header. Turning it off keeps the address |
| While it is off | Mail to the address is discarded. No conversation opens, and turning it back on does not recover it. Missed widget replies are not emailed either |
| Plan | Sending replies uses credits and needs a paid plan. See Plans |
Forward your own address
Keep the address your customers already know and forward it to the Median address. The mail lands in the same inbox.
Turn on email support
Follow Turn on email support and copy the address.
Add the forward
At your mail provider, forward everything sent to your support address to the Median address. Use the provider's forwarding or routing setting. The tables below link each provider's instructions.
Confirm the forward
Most providers send a confirmation link or code to the Median address first. It opens a conversation in the inbox. Open it and follow the link, or copy the code back into the provider.
Send a test
Write to your support address from an outside account. A conversation should open under that outside address, not under your own.
Mailboxes
| Where your mail lives | Instructions | Notes |
|---|---|---|
| Gmail | Automatically forward Gmail messages | Sends a confirmation link to the destination |
| Google Workspace | Redirect or forward Gmail messages to another user | Address maps in the Admin console, for an address the whole domain shares |
| Outlook.com | Turn on or off automatic forwarding | Asks you to turn on two step verification if the account does not have it |
| Microsoft 365 | Configure email forwarding | Admin center. Outbound spam policies can block forwarding outside the organization |
| Zoho Mail | Email forwarding | Confirms with a code sent to the destination |
| Fastmail | Set up mail forwarding | A rule on all messages, or a target address on an alias |
| Proton Mail | How to use email forwarding | Paid plans only. The destination confirms |
| iCloud Mail | Automatically forward email | Custom domain addresses are forwarded too |
| Yahoo Mail | Enable automatic email forwarding | Needs Yahoo Mail Plus |
Domains and hosts
Use these when your support address is an alias with no mailbox behind it.
| Where your domain lives | Instructions | Notes |
|---|---|---|
| Cloudflare Email Routing | Email routing rules and addresses | Add the Median address as a destination and verify it, then point a rule at it |
| cPanel host | Forwarders | An account forwarder for one address, a domain forwarder for all of them |
| Namecheap Private Email | Set up forwarding | Mail already filed as spam is not forwarded |
What arrives
Median matches mail on the envelope recipient and on every To and Cc
address. A forwarded email whose To line still names
support@yourcompany.com arrives. So does mail that copies the Median address.
| Part of the email | Becomes |
|---|---|
From address | The customer. Later mail from that address lands on the same customer, see Sender verification |
From display name | The customer's name when they have none yet, or only one Median looked up. Any other name already on the customer is kept |
| Subject | The conversation subject. Re:, Fw: and Fwd: are stripped. Up to 200 characters |
| Body | The message. Median reads the plain text part, or the HTML with its tags stripped. Up to 4,000 characters |
| Quoted history | Cut from the first On ... wrote:, Original Message, Forwarded message or > line |
| An empty body | The subject becomes the message |
| Attachments | Not imported |
A new email from the same address joins that customer's open email conversation, whatever its subject. Once that conversation is resolved or closed, the next email starts a new one. An email to an archived conversation brings it back to the inbox and ends a snooze. Email and widget conversations stay separate, even for the same customer.
Mail that is dropped
| Reason | |
|---|---|
| Sent while email support is off | The inbox is off |
From any @median.sh address | Stops forwarding loops |
Auto-Submitted set to anything but no | Out of office replies and other automatic mail |
Precedence set to bulk, junk or list | Newsletters, mailing lists and group addresses |
| No body and no subject | Nothing to answer |
Median keeps no copy of dropped mail and writes no log entry for it.
Sender verification
Median reads the authentication results on every email. A sender counts as
verified when DMARC passes, or when DKIM or SPF passes for the domain in the
From address.
Unverified mail is still delivered and answered. The difference applies when
the customer behind that address carries a signed in
identity. Then unverified mail opens a separate
customer instead, so a forged From line cannot act as that customer.
What goes back
Agent replies and team replies go out by email, wherever they were written. Notes and system lines do not.
| Part | Value |
|---|---|
| From | Ada at Acme <acme.support@median.sh>. The author's name, then your organization's name. Agent replies use the agent's name. With no author, or an author named like the organization, only the organization's name shows |
| Subject | Re: and the conversation subject, or Re: your message when it has none |
| Threading | In-Reply-To names the customer's newest email, and References carries the thread's Message-IDs, the newest 30 at most. Mail clients file the reply in the same thread, and a reply to it comes back to Median |
| Body | Markdown rendered as HTML, with a plain text copy |
| Footer | "Powered by Median", unless Show Median branding is off in Settings → Billing |
Replies always leave from the Median address. They cannot be sent from your own domain.
A reply that fails to send leaves The reply could not be emailed: <reason> in
the conversation and marks it unread. It also shows in
Logs as Email delivery.
Widget replies a customer missed
With email support on, Median also emails widget replies to customers who have left the page.
| Rule | Detail |
|---|---|
| Who | Widget customers with an email address on file |
| Presence | Only widgets that report presence. Conversations started over the REST API never get these emails |
| Timing | Checked 2 minutes after a reply lands. Sent when the widget has not been seen for 90 seconds |
| Content | Every reply since the customer last read the conversation or wrote in, in one email. Each reply is emailed once |
| From | The author's name at your organization when one author wrote them all. Otherwise the organization's name |
| Subject | Re: and the conversation subject |
Troubleshooting
| What you see | Cause | Fix |
|---|---|---|
| Nothing arrives | Email support is off, or the forward was never confirmed | Check the Email support switch, then the forwarding screen at your provider |
| The provider's confirmation never shows up | Median drops automatic mail, and some confirmations may be marked as automatic | Use a setting that sends no confirmation, such as Google Workspace address maps or a cPanel forwarder. Otherwise contact Median support |
| Conversations open under your own address | The forward rewrites the sender. A manual forward and a "forward as attachment" rule both do | Use the provider's forwarding or routing setting instead of a rule in your mail client |
| Mail sent to a group address never arrives | Groups and mailing lists usually add Precedence: list | Forward from a mailbox, an alias or a routing rule instead |
| Some mail arrives, some does not | Most providers do not forward what they filed as spam | Check the spam folder of the forwarding mailbox |
The reply could not be emailed: <reason> | The send failed for the reason given, such as running out of credits | Fix the cause, then send the reply again |
| That address already belongs to another organization. Change your slug and try again. | Another organization kept that address after changing its slug | Change the slug in Settings → General, then turn email support on |
| Email support is unavailable. Contact Median support. | Email is not set up on this deployment | Contact Median support |
| No switch and no Turn on email support button | Members cannot change integrations | Ask an admin or owner |
The other ways in are on Integrations.