Recipient address map

The Recipient address map setting is one of multiple options on the "Gmail settings" page for managing mail routing and delivery.

This setting enables you to apply mappings (aliases) to recipient addresses on messages received by your domain. You can map multiple individual recipient addresses (a maximum of 2,000 entries) to other addresses. Each individual address maps to exactly one other address, and multiple addresses can map to the same other address.

This is a basic routing concept—sometimes called a virtual user table—that's frequently used in mail routing situations to redirect mail from one address to another. By using this setting, you don’t need to create individual Default routing settings for each address mapping.

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

Configure the Recipient address map setting for your domain:

  1. Sign in to the Google Admin console.
  2. From the dashboard, go to Apps > G Suite > Gmail > Advanced settings.
  3. At the top of the page, ensure that the top-level org is highlighted.
  4. Scroll down to the Recipient address map section, or type Recipient address map in the search box:
    • 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).  
  5. Enter a short description that will appear within the setting's summary.
  6. Under Messages to affect, select All incoming messages or Only external incoming messages.
  7. Enter address mappings in the box.

    Each mapping must include two addresses on a single line, separated by a comma. Place the map-to address after the comma. In the following example, is the map-to address:,

    Each address must be a complete, specific address, and is case-insensitive.
  8. Click Add to add the mappings.
  9. Scroll down to the Options section, and select Add X-Gm-Original-To header if you want the recipient to know the original envelope recipient (the To address that the sender used).

    For example, the header might appear as:

    Adding the X-Gm-Original-To header is useful if you are rerouting a copy of the message to another recipient. In this case, you are changing the recipient address, but the recipient wants to know the address of the original envelope recipient. They can see the original envelope recipient by checking the X-Gm-Original-To header in the message.
  10. 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. 
  11. Click Save changes at the bottom of the "Email settings" page.
Note: When you're finished, click Add Setting (at the bottom of the dialog box), and then click Save changes (at the bottom of the "Email settings" page) to confirm your changes.
Was this article helpful?
How can we improve it?