Receiving routing setting
The Receiving routing setting is one of multiple options on the "Email settings" page for managing mail routing and delivery. The Receiving routing setting enables you to set up inbound and internal-receiving delivery options, such as dual delivery and split delivery.
Similar to other email security settings, the Receiving routing setting enables you to set up policies that vary by organizational unit. Users within child organizational units inherit the settings you create for the parent organization. You can also add multiple Receiving routing settings to each organizational unit.
After you configure an advanced Gmail setting, it may take up to one hour for that configuration to propagate to individual user accounts. You can track prior changes under Admin console audit log.
Use cases for the Receiving routing setting:
- Route inbound mail to both Gmail and an external server (dual delivery)—With dual delivery, users receive their mail in two inboxes. For example, users can receive mail in both their legacy inbox (for example, Microsoft Exchange or an archiving server) and their G Suite inbox. Incoming mail is delivered to Gmail (the primary delivery), which processes and delivers each message, and a copy is also forwarded to Exchange (the secondary delivery), which delivers it to the second box.
- Route inbound mail based on organizational unit (split delivery)—Use the Receiving routing setting to set up split delivery so that mail is routed to different mail hosts depending on the recipient's organizational unit. For example, you can set up one organizational unit to route inbound mail to the Microsoft Exchange mail host. For another organizational unit, you can use the default routing configuration (direct delivery) so that inbound mail is delivered directly to Gmail.
To configure Receiving routing settings for your domain or organizational unit:
- Sign in to the Google Admin console.
- From the dashboard, go to Apps > G Suite > Gmail > Advanced settings.
- In the Organizations section, highlight your domain or the organizational unit for which you want to configure settings (see Configure advanced settings for Gmail for more details).
- Scroll down to the Receiving routing section:
- If the setting's status is Not configured yet, click Configure (the "Add setting" dialog box displays).
- If the setting's status is Locally applied or Inherited, click Edit to edit an existing setting (the "Edit setting" dialog box displays), or click Add another to add a new setting (the "Add setting" dialog box displays).
- When you're finished making changes, click Add setting or Save to close the dialog box.
Note: Any settings you add will be highlighted on the "Email settings" page.
- Click Save changes at the bottom of the "Email settings" page.
In the "Receiving routing" window, click Add a description to enter a unique name for this setting. See the sections below for additional instructions and guidelines.Email messages to affect
- Inbound—Messages received by your users from senders outside the set of domains associated with your company or organization
- Internal - receiving—Messages received by your users from senders within the set of domains associated with your company or organization
For the Receiving routing setting, two options are available in the drop-down list: Reject message or Modify message.
This option rejects inbound or internal-receiving messages if the intended recipient is a user in this organizational unit. You can also enter customized text for the rejection notice.
This option enables you to modify inbound or internal-receiving messages by adding headers, changing the route, changing the envelope recipient, adding more recipients (additional, or secondary routes), or removing attachments. With this option, you can change the primary delivery, and you can define additional or secondary deliveries that you can use for dual delivery or multiple delivery. See the following descriptions for more details about these controls.Add X-Gm-Original-To header
By checking this box, a header tag is added in case the recipient is changed so that the downstream server can know the original envelope recipient; for example, X-Gm-Original-To: email@example.com.
Adding the X-Gm-Original-To header is useful if you're rerouting a copy of the message to another recipient. In this case, you're changing the recipient address, but the new recipient wants to know the address of the original envelope recipient, and can see the original envelope recipient by checking the X-Gm-Original-To header in the message.
Messages that are routed through Gmail are automatically filtered for spam and phishing. Selecting Add X-Gm-Spam header and X-Gm-Phishy header adds the following headers to indicate the spam and phishing status of the message:
0 indicates that a message is not spam: X-Gm-Spam: 0
1 indicates that a message is spam: X-Gm-Spam: 1
0 indicates that a message is not phishing: X-Gm-Phishy: 0
1 indicates that a message is phishing: X-Gm-Phishy: 1
Note: Any message marked as phishy is automatically marked as spam.
Choosing the Add X-Gm-Spam header and X-Gm-Phishy header option enables an administrator at a downstream server to set up rules that handle spam and phishing differently from clean mail.
You can add one or more custom headers to messages that are affected by a Receiving routing setting, Sending routing setting, or other setting. For example, you can add a header that matches the description that you entered for the setting. This can be helpful for analyzing why a message was routed in a certain way, or why a filter was triggered.
You can enter a string to prepend to the subject of messages. For example, if you enter Confidential in this field, message recipients might see the following subject: [Confidential] Monthly report.
The Change route option enables you to change the destination of the message. By default, the Gmail mail server is the primary delivery location. However, you can change the delivery location; for example, by routing mail to an on-premise mail server such as Microsoft Exchange.
Before you can change the delivery location, you must first add mail routes with the Hosts tab. The routes that you add on the Hosts tab are then visible in the route drop-down list.
The Reroute spam option is visible when you check the Change route box. Reroute spam enables you to route all mail that matches the criteria of the setting, including mail that has been marked as spam. If you check the Change route box but do not check the Reroute spam box, then normal mail is rerouted but spam mail is not rerouted (spam messages are stored in the G Suite platform for 30 days).
- Whether you check the Reroute spam box or not, blatant spam is not rerouted since it’s dropped instantly at delivery time.
- If mail is classified as spam but one of the G Suite email settings overrides that (for example, due to a sender whitelist), then the mail is not considered to be spam for this purpose and will be rerouted as normal mail.
To change the envelope recipient, click the option next to the Replace recipient field, and enter the user's email address; for example, firstname.lastname@example.org.
Changing the envelope recipient for a message on the primary delivery is equivalent to forwarding a message to a different recipient. You can also change the envelope recipient on the additional (secondary) delivery, which is equivalent to a "bcc".
Select this option to deliver incoming messages to recipients even if the spam filter identifies these messages as spam.
Select this option to remove any attachments from messages. Optionally, you can append text to notify recipients that attachments were removed.
- Check the Add more recipients box to set up additional (or secondary) deliveries for dual delivery or multiple delivery.
- Select Basic from the drop-down list to add individual email addresses, and then click Save. Click Add to add multiple recipient addresses.
- Select Advanced from the drop-down list to choose advanced options for your secondary delivery. Similar to the settings that you modified for the primary delivery, you can change the envelope recipient, add headers, prepend a custom subject, and remove attachments for the secondary deliveries.
Any settings that you configure for the primary delivery also affect the secondary deliveries. For example, if you change the envelope recipient, prepend a custom subject, and add custom headers to the primary delivery, the same configuration is applied to the secondary deliveries.
For secondary deliveries, the Do not deliver spam to this recipient and Suppress bounces from this recipient boxes are checked by default. Suppress bounces from this recipient prevents bounces from going back to the original sender.
Check this box to include secure delivery as part of content compliance for outbound messages.
For more details and step-by-step instructions about mail routing, including use cases and examples, see Manage mail routing and delivery: Guidelines and best practices.
Execute this setting only if the envelope sender matches
This option is useful to re-route mail for all users in an organizational unit, but only for messages sent from a few different domains. Click the check box, and then enter the list of domains with the following regular expression syntax:
This syntax causes any message from the above domains to adhere to the route modifications that you made.
Execute this setting only if the envelope recipient matches
This option is useful (for example) to re-route mail to your Microsoft Exchange server for just four users in a specific organizational unit. Using the Receiving routing setting for that organizational unit, you can change the primary delivery to your Exchange server. You can then ensure that this re-route applies only to these four users by entering the list of users with the following regular expression syntax:
For more information, see Guidelines for using regular expressions.