Google Email Alias Support


When enabled, new users pushed from Okta to Google Workspace will have any additional email aliases automatically populated in Google. When performing an import from Google, newly imported users will have their email aliases pulled in from Google and set on the emailAliases property of the Google app user. If profile sourcing for Google is enabled, existing users will also get their emailAliases attribute updated when an import from Google is run.


To enable email alias functionality with existing Google Workspace app instances you need add the emailAliases property to your app instance’s schema as follows:

  1. In Okta, navigate to Directory > Profile Editor.

  2. Click the Profile edit icon.

  3. Click Add Attribute.

  4. Click Refresh Attribute List.

    At this point emailAliases should be available to be added to your instance.

  5. Select emailAliases, then click Save.

Subsequent user push and import operations will now be email alias aware. If the emailAliases property is unmapped to the Okta user, then upon app assignment you will be prompted on the App Assignment screen to optionally add email aliases prior to Okta pushing the user to Google.

Note: If Okta is configured to Google Workspace Update User Attributes and the emailAliases Google Workspace attribute has not been mapped to an Okta attribute, Okta will replace existing Google Workspace email alias values with a blank value. We therefore highly recommend utilizing Universal Directory to establish an Okta > Google Workspace attribute mapping that will populate the emailAliases attribute with a value from the Okta profile. Refer to About Attribute Mapping for more details.

If mapped to the Okta user, aliases can then be pushed/pulled from/to Google and other apps like any other property.


  • Google enforces that the domain name of every email alias must be registered and verified within Google first. Therefore pushing an unverified domain to Google will result in an error.

  • Google enforces a maximum limit of 30 aliases.

  • For additional information see:

  • Okta will need to make additional API calls to fetch, create and update email aliases and these calls will count against your Google API Quotas.

  • On User Push to Google, Okta only reconciles addresses once a value has been assigned to the app user’s emailAliases property. Once a value is populated, even with an empty value, it will be pushed and overwrite Google.

  • For all users, both the username and email alias need to be unique values.