Redirect incoming messages with address maps

This article is for Google Workspace administrators who want to set up message redirects for their organization. Google Workspace users can Forward email to other Google Workspace accounts. Personal Gmail account users can Automatically forward Gmail messages to another account.

As an administrator, you can create address maps to redirect incoming messages to email addresses that are different from the original recipient or destination. An address map is a relationship (or map) between the original recipient of a message and a set of different or additional recipients that you specify.

Note: Message forwarding and message redirecting are different. Forwarding changes the content of the original message, and forwarded messages include message history. Redirecting doesn't affect message content, and redirected messages appear to come directly from the original sender.

Address map examples

  • An employee left your organization, but you want to get any future messages sent to their email address. Map their employee email address to an address where you want to get those messages.
  • You want to use one email address to send messages to multiple recipients. For example, you can map the email address to the email address of each of your sales employees. When you send a message to, a copy is sent to the inbox of every person on your sales team.
  • Someone in your organization changed their name and email address. Map their old email address to the new one so they can continue to get messages sent to their old address.
  • A person in your organization has an email address that's often misspelled. Create an alias with the misspelled address, then map the alias to the person's correct email address. Messages sent to the misspelled address are redirected to the correct address.

Mapped addresses are stored in an address map table in your Google Admin console. Each row in the table is an address map, and each address map can include up to 5,000 recipient addresses. A single email address can be mapped to up to 12 other addresses.

Depending on your email sending practices, we may reduce the recipient address limit for your domain. This can affect recipient limits for your address maps. We recommend you follow our best practices for sending mail to Gmail users.

Add a Gmail address map

  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 thenGoogle Workspaceand thenGmailand thenRouting.
  3. On the left, select the top-level organizational unit.
  4. Scroll down to the Recipient address map setting, then click Add or Add another rule
  5. In the Add setting box, take these steps:
    Setting What to do

    Enter a descriptive name for the address map. This name is displayed in the address map table.

    1. Messages to affect

    Choose one option:

    • All incoming messages: Apply the setting to all received messages.
    • Only external incoming messages: Apply the setting only to messages from senders outside your organization.
    2. Routing options

    (Optional) To also send the message to the original recipient, check the Also route to original destination box.

    3. ...Rewrite the recipients

    To add address maps one at a time:

    1. In the Address field, enter the original email address.
    2. In the Map to address field, enter the addresses you want to map to.
    3. Click Add.

    To add multiple address maps at once:

    1. Click Bulk Add.
    2. Enter the original email address followed by a comma, then enter the new recipient address.
    3. Use the Return or Enter key to add a new line.
    4. Repeat Steps 2 and 3 until you’ve added all address maps.
    5. Click Add aliases.
    4. Options (Optional) To keep the original recipient information in the message header, check the Add X-Gm-Original-To header box. You might want to do this if the servers you forward to manage messages based on message header information. Message header information can also be useful for troubleshooting email delivery.
  6. At the bottom of the Add setting box, click Save

It can take up to 24 hours for changes to take effect. You can track changes in the Admin audit log.

Related topics

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center