# Gmail Labels to Outlook Folders: What to Expect After a G Suite to Office 365 Migration

> Gmail labels are not folders. Learn what Microsoft documents about labels, rules and exclusions in a Google Workspace migration, and how to test and tidy up in Outlook.

Source: https://www.epifive.com/blog/gmail-labels-to-outlook-folders-after-migration · Published 2026-11-19 · EpiFive

## Key takeaways

- Gmail uses labels and one message can carry several; Outlook uses folders, so the model changes after migration.
- Microsoft does not publish a label-to-folder mapping table for the Google Workspace migration, so test a pilot mailbox first.
- For a Google Workspace migration, -ExcludeFolders and -IncludeFolders take Gmail label names, are not case-sensitive and accept no wildcards.
- Gmail filters arrive as Outlook rules that are turned off by default, so each user must review them before enabling.
- Outlook categories are the closest match for putting one message under several topics, but they do not work on IMAP accounts.

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](https://www.epifive.com/blog/google-workspace-to-m365-enterprise-migration-guide): 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](https://www.epifive.com/blog/google-workspace-to-microsoft-365-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](https://www.epifive.com/blog/outlook-rules-auto-move-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](https://www.epifive.com/blog/migrate-google-calendar-contacts-to-outlook-microsoft-365).

### 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.

```powershell
$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 GmailBatch1
```

Microsoft'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.

1. Before the migration, note in Gmail the label list, one nested label, and one message that carries two or three labels.
2. After the pilot batch syncs, open the mailbox in Outlook and compare the folder list with your note.
3. Search for the multi-label message by subject. Record how many copies you find and in which folders.
4. Check whether starred or important mail is easy to find in the way users expect.
5. Open the rules list and confirm the rules exist and are off.
6. 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

1. Create a short folder list in Outlook that matches how you search, not how Gmail was shaped.
2. Move older mail with a rule or by hand; keep the tree shallow.
3. Use categories for the cross-topic tags you used to apply as extra labels.
4. Enable the migrated rules that still apply, one at a time.
5. 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](https://www.epifive.com/blog/google-drive-to-onedrive-sharepoint-migration-manager) covers that side, and the [email migration cutover checklist](https://www.epifive.com/blog/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 `-ExcludeFolders` and `-IncludeFolders` use 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](https://learn.microsoft.com/en-us/exchange/mailbox-migration/perform-g-suite-migration)
- [Perform an automated Google Workspace migration in the EAC](https://learn.microsoft.com/en-us/exchange/mailbox-migration/automated-migration-neweac)
- [Perform a Google Workspace migration using Exchange Online PowerShell](https://learn.microsoft.com/en-us/exchange/mailbox-migration/perform-gspace-migration-powershell)
- [New-MigrationBatch](https://learn.microsoft.com/en-us/powershell/module/exchangepowershell/new-migrationbatch)
- [Create and manage labels in Gmail](https://support.google.com/mail/answer/118708)
- [Organize and archive email in Gmail](https://support.google.com/mail/answer/9259770)
- [Create and assign color categories in Outlook](https://support.microsoft.com/en-us/outlook/mail/create-and-assign-color-categories-in-outlook)

## Frequently asked questions

### Do Gmail labels become Outlook folders when I migrate to Microsoft 365?

Microsoft's Google Workspace migration documentation does not publish a label-to-folder mapping table, so do not assume one. It does say that for a Google Workspace migration the folder parameters use label names from the source. Migrate a pilot mailbox and inspect the result in Outlook before you promise users anything.

### How do I leave certain Gmail labels out of the migration?

Start the batch with Exchange Online PowerShell and use the -ExcludeFolders parameter of New-MigrationBatch with the label names. Microsoft says folder names are not case-sensitive and wildcard characters cannot be used. The reverse parameter, -IncludeFolders, migrates only the labels you list.

### What happens to Gmail filters after the move?

Microsoft lists Mail and Rules as migrated, and says the migrated rules remain turned off by default. Ask users to review each rule in Outlook before turning it on. Admins can prevent the move of rules with the batch's rules filter or the -SkipRules parameter.

### Can an Outlook message sit in two folders like a Gmail message with two labels?

A message lives in one Outlook folder at a time. For the multiple-label habit, Outlook categories are the closest feature, because Microsoft says you can assign more than one color category to an item. Categories do not work with IMAP accounts, and other people do not see the ones you assign.

