Gmail labels do not become a perfect copy of your folder tree in Outlook, because a label is a tag and an Outlook folder is a location. Microsoft's documentation for a Google Workspace migration confirms that labels are used to include and exclude content, but it does not publish a mapping table, so the safest plan is to exclude what you do not need, migrate a pilot mailbox, and look at the result before everyone moves.
This article covers one slice of a G Suite to Office 365 migration: what happens to labels, how to control them in the batch, and how end users can tidy up afterward. For the whole project, use the migration checklist.
Who this is for and what you will have at the end
This is for end users who are about to lose their Gmail sidebar and for the admin who has to answer "where did my labels go?" It is written as questions and answers, because that is how the questions arrive on migration week.
At the end you will know what Microsoft states about labels, filters and exclusions. You will also have a pilot-mailbox test, an admin command that skips noisy labels, and a tidy-up routine for users.
Why labels and folders are different things
Google's Gmail Help says it plainly: "Labels are different from folders. Only you can access your labels. The people you email don't get them." On the Organize and archive page, Google adds that Gmail does not use folders, that you can drag messages into labels, and that you can apply multiple labels to a message and find it by clicking any of its labels in the left panel.
That second point is the whole problem. A newsletter tagged Finance, Q4 and Receipts is one message with three labels in Gmail. Outlook stores a message in one folder, so no migration can make the three-label habit work identically. Gmail also lets you nest labels: in the label dialog you check "Nest label under" to place one label inside another, and Google states you can create up to 5,000 labels.
| Gmail concept | Outlook concept | Practical difference |
|---|---|---|
| Label | Folder (location) or category (tag) | A message sits in one folder at a time |
| Several labels on one message | One folder plus optional categories | Decide which label becomes the "home" |
| Nested label ("Nest label under") | Subfolder | Check the shape of the tree after the pilot |
| Filter | Rule | Migrated rules stay off until the user enables them |
| Starred, Important | Flag, or a category | Verify on a pilot mailbox; not described by Microsoft |
Q&A for end users
Will my labels show up in Outlook?
Microsoft's page on performing a Google Workspace migration says you can migrate Mail and Rules, Calendar and Contacts. It does not include a table that maps each Gmail label type to an Outlook folder, and it does not describe how a message with several labels is placed. Treat any claim that says otherwise, including this article, as unverified until you see your own pilot mailbox.
What to do: ask the admin to migrate one or two real mailboxes first, and compare the Outlook folder list with Settings, See all settings, Labels in Gmail, which lists every label.
What should I do before the move?
Spend ten minutes in Gmail. Open Settings, choose See all settings, then the Labels tab, and write down the labels you actually use. Delete or hide the ones you have not touched in years; fewer labels means a smaller, cleaner result.
Then decide a "home" for mail that carries several labels. A simple rule is to pick the label that answers "where would I look first?" and treat the others as search terms.
Do my Gmail filters come with me?
Microsoft's limitations section says rules are migrated and remain turned off by default, and advises users to verify the rules in Outlook before enabling them. Open Outlook, go to the rules list, read each one, and turn on only the ones that still make sense. Existing rules in the guide Outlook rules: auto-move and forward emails show the building blocks.
Can I keep tagging one message with several topics?
Yes, with categories. Microsoft's support pages say you can assign more than one color category to an item by repeating the Categorize step. In the new Outlook, you select Categorize on the toolbar, then search for or select a category; to remove one, clear its check mark. Two limits from the same pages: categories cannot be assigned if you use Outlook with an IMAP account, and other people will not see the categories you assign.
Because Outlook categories are personal, they suit "my own sorting" and not shared team conventions. For shared sorting, use real folders in a shared mailbox.
Admin: control what the batch migrates
Microsoft's page documents two controls that matter for labels. Both apply to the Exchange admin center (EAC) batch or to PowerShell, with differences noted below.
Filter options in the EAC batch
In the EAC, go to Migration, choose Add migration batch, and select Google Workspace (Gmail) migration. On the Move configuration page, the migration filtering options show Mail, Calendar, Contacts and Rules, all checked. Clear the ones you do not want. The calendar and contacts side is covered in Migrate Google Calendar and Contacts to Outlook.
Exclude labels with ExcludeFolders
If you start the batch from Exchange Online PowerShell, Microsoft says you can use the -ExcludeFolders parameter to prevent certain folders from being migrated. That reduces the amount of data and the size of the new mailbox. The parameter page states that for a Google Workspace migration you use label names on the source, that names are not case-sensitive with no character restrictions, and that wildcard characters cannot be used.
The following sketch adapts Microsoft's documented Google Workspace example. The endpoint, CSV path and domain names are placeholders, and the excluded label names are examples you replace with your own.
$endpoint = Get-MigrationEndpoint -Identity GmailEndpoint
New-MigrationBatch -SourceEndpoint $endpoint.Identity -Name GmailBatch1 `
-CSVData $([System.IO.File]::ReadAllBytes("C:\Migration\gmail.csv")) `
-TargetDeliveryDomain "o365.contoso.com" `
-ExcludeFolders "Promotions","Old newsletters"
Start-MigrationBatch -Identity GmailBatch1Microsoft's own example uses the opposite parameter. It passes -IncludeFolders "Payment" together with -ContentFilter "Received -ge '2019/4/30'" so that only the Payment label and only mail received after that date is migrated. Use IncludeFolders when you want a short allow-list and ExcludeFolders when you want to drop a few labels.
Rules
The same page tells admins that, when starting the batch with PowerShell, the -SkipRules parameter prevents the migration of Gmail filters as Outlook rules. Consider this if users have years of stale filters that would only confuse the first week in Outlook.
Settings Microsoft says do not migrate
The limitations table also lists Vacation settings and Automatic reply settings for mail. Ask users to set an automatic reply in Outlook again before the cutover day if they will be away.
Pilot test: a repeatable checklist
Run this with one real mailbox, ideally one that has nested labels and some multi-label mail.
- Before the migration, note in Gmail the label list, one nested label, and one message that carries two or three labels.
- After the pilot batch syncs, open the mailbox in Outlook and compare the folder list with your note.
- Search for the multi-label message by subject. Record how many copies you find and in which folders.
- Check whether starred or important mail is easy to find in the way users expect.
- Open the rules list and confirm the rules exist and are off.
- Decide the user guidance from what you saw, not from assumptions.
Whatever you find, write the results into the user communication. People are far more forgiving of a change they were told about.
Troubleshooting
| Symptom | Likely cause | What to do |
|---|---|---|
| Mailbox much larger than expected | All labels, including big archives, were migrated | Re-plan with -IncludeFolders or -ExcludeFolders on later batches |
| Items reported as "missing" at verification | MRM or archive policies moved or deleted items | Microsoft recommends disabling MRM and archival policies before migrating |
| A large message did not arrive | Transport limit | Microsoft says the default largest message that can be migrated is 35 MB, based on the tenant transport configuration |
| Rules do nothing | Migrated rules are off by default | Open the rules list and enable them one by one |
| Categories will not apply | Account is IMAP | Categories cannot be assigned on IMAP accounts |
The "missing items" row deserves care. Microsoft explains that its data migration tool is unaware of messaging records management or archival policies, so deleted or archived messages are flagged as missing, which looks like data loss when it is not.
After the move: a user tidy-up routine
- Create a short folder list in Outlook that matches how you search, not how Gmail was shaped.
- Move older mail with a rule or by hand; keep the tree shallow.
- Use categories for the cross-topic tags you used to apply as extra labels.
- Enable the migrated rules that still apply, one at a time.
- Use the search box in Outlook for retrieval; the habit of searching by label name often transfers well.
If you are also moving files, the Google Drive to OneDrive and SharePoint guide covers that side, and the email migration cutover checklist covers the day itself.
Closing checklist
- Users list the labels they use and choose a home folder for multi-label mail.
- Admin decides which labels to include or exclude and whether to skip rules.
- A pilot mailbox is migrated and compared against the Gmail label list.
- Users are told that rules arrive turned off and that automatic replies must be recreated.
- Categories are explained as the replacement for multiple labels.
What we checked
- Opened Microsoft's "Perform a Google Workspace migration" page on learn.microsoft.com on 2026-11-19 (page metadata showed an update date of 2026-10-14). It lists Mail and Rules, Calendar and Contacts as migratable, and the limitations table lists Vacation settings and Automatic reply settings for mail.
- On the same page, confirmed the statements that rules are migrated and remain turned off by default, that folder exclusion is available when starting the batch with PowerShell, and that the default largest migratable message is 35 MB.
- Opened the New-MigrationBatch reference on 2026-11-19 and confirmed that
-ExcludeFoldersand-IncludeFoldersuse label names for a Google Workspace migration, are case-insensitive, and do not allow wildcards. Documented example:-IncludeFolders "Payment"with-ContentFilter "Received -ge '2019/4/30'". - Opened the automated EAC migration page on 2026-11-19 and confirmed the Move configuration page shows Mail, Calendar, Contacts and Rules filters, all checked.
- Opened Gmail Help "Create and manage labels in Gmail" on 2026-11-19 and confirmed the "Labels are different from folders" wording, the "Nest label under" option and the 5,000 label limit. Google's "Organize and archive email" page confirmed multiple labels per message.
- Checked Microsoft's Outlook categories support pages through search results on 2026-11-19 for multiple categories per item and the IMAP limitation.
- Not checked: we did not run a migration, and Microsoft's documentation does not state how multi-label messages or Starred and Important mail are placed in Outlook, so the article gives no claim on that. The PowerShell block is an adaptation of Microsoft's example and was not executed.
Last tested: 2026-11-19
References
- Perform a Google Workspace migration to Microsoft 365 or Office 365
- Perform an automated Google Workspace migration in the EAC
- Perform a Google Workspace migration using Exchange Online PowerShell
- New-MigrationBatch
- Create and manage labels in Gmail
- Organize and archive email in Gmail
- Create and assign color categories in Outlook
Comments
Questions and tips are welcome. Comments are checked by the EpiFive team before they appear; please do not share passwords, phone numbers or other private details.