Receiving routing setting
The Receiving routing setting is one of multiple options on the Email settings page for managing mail routing and delivery. Receiving routing 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 set up policies that vary by organizational unit. Users within child organizational units inherit the settings you create for the parent organization. You also have the option to add multiple Receiving routing settings to each organizational unit.
Use cases for Receiving routing:
- 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 Google Apps 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.
- Click Google Apps > 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
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), and/or removing attachments.
With the Modify message 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 clicking this check 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 they 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, Sending routing, 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
This option enables you to change the destination of the message. By default, the Gmail mail server is the primary delivery. However, you can change the delivery; for example, by routing mail to an on-premise mail server, such as Microsoft Exchange.
Before you can change the primary delivery, you must first add mail routes with the Hosts tab. The routes that you add on the Host tab are then visible in the Select a route drop-down list.
To change the envelope recipient, click the radio button 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".
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. You can add multiple recipient addresses by clicking Add.
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.
Note: Any settings that you configure for the primary delivery will 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.
Select this option to remove any attachments from messages. Optionally, you can append text to notify recipients that attachments were removed.
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.
This option is useful if you want 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 would cause 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 if (for example) you want 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.