Add a user alias domain or secondary domain  |  Domain management  |  Google Workspace Help Skip to main content Domain management Documentation Administrators Getting started Apps and integrations Set up and manage services Billing and subscriptions Data migration Data synchronization Device management Domain management Reports and monitoring Security and data protection User management Legal and compliance Support and troubleshooting Users Calendar Chat Cloud Search Gmail Groups Docs, Forms, Sheets, and Slides Drive Keep Meet Meet Hardware Sites Vids Developers Apps Script Marketplace Workspace APIs Training & business user guides Workspace Learning Center Google Skills Community Communities Workspace Admin Community Workspace Developers Community Support / English Deutsch Español – América Latina Français Indonesia Italiano Nederlands Polski Português – Brasil Svenska Tiếng Việt Türkçe Русский עברית العربيّة فارسی हिंदी বাংলা ภาษาไทย 中文 – 简体 中文 – 繁體 日本語 한국어 Sign in Administrators Domain management Admin console Contact us Overview Guides Domain management Overview Guides Documentation More Community More Support Domain basics What is a domain? Domain name basics DNS basics Identify your domain registrar Settings managed by your domain registrar DNS records About A records Configure A records Troubleshoot A records About CNAME records Add a CNAME record to your domain's DNS records Set up MX records for Google Workspace Avoid issues when changing MX records TXT record values Verify your domain with a TXT record Troubleshoot TXT records Manage your domains Choose your primary domain Add a user alias domain or secondary domain FAQ for multiple domains Limitations with multiple domains Merge domains from separate accounts Separate a Google Workspace account into two accounts Remove a domain from your managed Google Account Allow external sharing with only trusted domains Change your primary domain Change your primary domain for Google Workspace Alternatives to changing your primary domain Rename user addresses in bulk after changing your primary domain Verify your domain Verify your domain for Google Workspace Verify your domain to unlock features (for business email accounts) Verify your domain to unlock features (for Gmail accounts) About Gmail-based Google Workspace accounts Domain registration & hosting Purchase a domain when you sign up for Google services Connect your website to a domain registered through Google Use non-Google services with a domain registered through Google Set up Google Workspace with a third-party DNS host Transfer your domain to another host Unlock your domain Google Domain Registration Migration to GoDaddy Manage domains registered through Blogger Problems with domains registered through Google Renew an expired domain registration Verify billing information for legacy domain registrations Google Workspace Domain Transfer service What is Google Workspace Domain Transfer? How Domain Transfer works Workspace domain transfer words to know Domain Transfer system requirements What's supported in Domain Transfer? What's not supported in Domain Transfer? Watchpoints for Domain Transfer 1. Transfer process framework 2. Remove dry-run blockers 3. Choose your transfer options 4. Execute a dry run & schedule a transfer 5. Complete pretransfer tasks 6. Execute the transfer 7. Complete post-transfer tasks Identity merge & deduplication Transfer your Vault data with a domain transfer Known issues with Domain Transfer Administrators Getting started Apps and integrations Set up and manage services Billing and subscriptions Data migration Data synchronization Device management Domain management Reports and monitoring Security and data protection User management Legal and compliance Support and troubleshooting Users Calendar Chat Cloud Search Gmail Groups Docs, Forms, Sheets, and Slides Drive Keep Meet Meet Hardware Sites Vids Developers Apps Script Marketplace Workspace APIs Training & business user guides Workspace Learning Center Google Skills Communities Workspace Admin Community Workspace Developers Community Google Workspace Help Administrators Domain management Guides Send feedback Add a user alias domain or secondary domain Stay organized with collections Save and categorize content based on your preferences. For your Google Workspace or Cloud Identity account If you own another domain, you can add it to your Google Workspace or Cloud Identity account. For example, you might manage multiple businesses or brands, each with their own domain. Depending on your needs, you add a domain as a user alias domain or a secondary domain. If you try to add a domain that includes "gmail" in its name, it won't be accepted. For example, if you try to add a domain such as xxgmailxx.com, you'll get an error. Give users an email address at another domain Manage separate teams of users or businesses at different domains Users get email addresses at both domains. Users can send and receive email from either address No extra cost per user You have different users for each domain. A user gets a Google Workspace account, email address, and mailbox for their domain Pay for each user account (does not include aliases) that you add to your secondary domain* * Except for organizations with Education Fundamentals edition Help me choose More about user alias domains & secondary domains About user alias domains Give users an email alias at another domain For example, you signed up for Google Workspace with your-company.com (your primary domain). You own the domain other-company.com and add it as a user alias domain. Each user gets an email address at both your primary domain and the user alias domain. Everyone can send and receive email from either address. Ann's address ann@your-company.com Ann's email alias ann@other-company.com Each mailing group also gets an email address at the user alias domain. For example, if you have info@your-company.com, you automatically get info@other-company.com. No extra cost per user or group. Add up to 20 user alias domains to your Google Workspace account. Note: A user's alias address might be visible to other users. For example, if a recipient searches Gmail for messages from Ann, search results might include messages from ann@your-company.com and ann@other-company.com. Learn more in the FAQ and Limitations with multiple domains. If you manage a large organization: Your users might have a personal Google Account that already uses the domain. When you add the user alias domain, those users' accounts are automatically renamed. All data in the accounts remains outside of your organization's management. To find users with accounts, first add the domain as a secondary domain. The list of accounts is generated within 24 hours. Learn more about conflicting accounts. About secondary domains For separate teams at different domains For example, you signed up for Google Workspace with your-company.com (your primary domain). You manage a team that has their own domain, other-company.com. You add other-company.com as a secondary domain to your Google Workspace account. Each of your domains has a different set of users. Users get a Google Workspace account, email address, and mailbox for their domain. Pay for each user account (except for organizations with Education Fundamentals edition). Manage all domains and users in the Admin console for your primary domain. Add up to 599 secondary domains. You can add a user alias domain to a secondary domain (requires the Directory API). Or switch the secondary domain to be the primary domain for your Google Workspace account. Learn more Important: Some information and features are linked only to your primary domain. For example, you can't set up a separate billing address or company logo for a secondary domain. Learn more in the FAQ and Limitations with multiple domains. Add a domain to your account In the Google Admin console, go to Menu Account Domains Manage domains. Go to Manage domains Requires having the Domain settings administrator privilege. In Manage domains, click Add a domain. Note: If you have the legacy free edition of Google Workspace, the "Add a domain" option isn't available. Enter the name of the domain you're adding. If you recently removed this domain from your Google Workspace account, you need to wait up to 24 hours before adding the domain. Check troubleshooting tips. Select a domain type: Secondary domain if you plan to replace your primary domain with this new domain. if you want to add a new domain for a separate team or business unit. User alias domain: if you want to add email aliases (alternate email addresses) for your existing users. Google Workspace will automatically create aliases after you've added the domain. Click Add domain & start verification. Follow the instructions to verify that you own the domain. If adding a domain requires multi-party approval, wait for approval before completing the next steps. For details, go to Multi-party approval for sensitive actions. If you want to use Gmail with this domain, return to Manage Domains after your domain is verified. Find the new domain and click Activate Gmail. Follow the instructions to set up Gmail for your new domain. Start using your new domain Send and receive messages with your alternate email address Once your user alias domain is active, users can use their new alternate email addresses to send and receive messages. Tip: Share instructions with your users. How primary email and alias addresses work together People can share files with either the primary email address or alias address. You and your users sign in to Google Workspace accounts with the primary email address—not the alias address. You and your users can create documents and files only with the primary email address. Google Calendar invites and sharing invites are sent only from the primary email address. Send messages from your alias address To send message, add your alias address to your Gmail account. On your computer, open Gmail. In the top right, click Settings Settings. Click the Accounts and Import or Accounts tab. In the Send mail as section, click Add another email address. Enter your name and your alias address. Check the Treat as an alias box. Click Next Step and follow the confirmation steps. When you send a message in Gmail, click From to select your alias address. Receive messages at your alias address Messages sent to your alias address automatically arrive in your inbox. To test, send a message from another account (not your Google Workspace account) to your new alias. If you don't receive the test message within 48-72 hours, contact your domain host. They can check whether your domain verification and MX records (for email) are set up correctly. Add users and email addresses to your secondary domain Once your secondary domain is active: Follow the steps to add user accounts in the secondary domain. After you enter the user's Primary address, you choose the domain. At the right of the @ sign, click the Down arrow and select the user's domain. For tips on managing users accounts, go to Limitations with multiple domains. Related topics Give a user an additional "email alias" address (sales@) Change your primary domain Adding a domain vs. signing up for another account Send feedback Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Last updated 2026-07-17 UTC. Need to tell us more? [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-07-17 UTC."],[],[]] Try Google Workspace Boost your productivity with AI at no cost Admin Community Get answers from industry peers and experts Customer Care Learn about support options and services Documentation & training Help Centers Developer guides Learning Center Google Skills Tools Admin console Apps Script Dashboard Google Cloud console Support Admin Community Developers Community Customer Care Terms Privacy Manage cookies English Deutsch Español – América Latina Français Indonesia Italiano Nederlands Polski Português – Brasil Svenska Tiếng Việt Türkçe Русский עברית العربيّة فارسی हिंदी বাংলা ภาษาไทย 中文 – 简体 中文 – 繁體 日本語 한국어