Apply aliases to recipient addresses

You can apply mappings (aliases) to recipient addresses on messages received by your domain. 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 routing settings for each address mapping.

  • You can map multiple recipient addresses (a maximum of 5,000 entries) to other addresses.
  • You can map an individual recipient address to a maximum of 12 addresses.

Configure the recipient address map setting for your domain

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenGmailand thenAdvanced settings.

    Tip: To see Advanced settings, scroll to the bottom of the Gmail page.

  3. On the left, ensure that the top-level org is highlighted.
  4. Scroll down to the Routing section and find Recipient address map.

    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. At the top, 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. Under Routing options, check the Also route to original destination box to send a copy of the message to the new address and also deliver it to the original recipient.

    Note: If you don’t select this option, the message is only sent to the new address.

    For example, is in the address map and the new address is If the checkbox is checked, both and will receive a copy of the message. If the checkbox is unchecked, then only will receive the message. 
  8. 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. An address can be mapped to multiple map-to addresses. In the following example, is mapped to both and,, 

  9. Click Add to add the mappings.
  10. When you're finished making changes, click Add setting or Save to close the dialog box.
    Note: Any settings you add are highlighted on the Email settings page. 
  11. Click Save changes at the bottom of the Email settings page.

It can take up to an hour for changes to propagate to user accounts. You can track changes in the Admin audit log.



Was this helpful?
How can we improve it?