Home > Gmail Migration > Overview
Export to PDFRefer to the table below to view the supported and unsupported object types for Gmail Migration.
√ – Supported; × – Unsupported.
*Note: The object types that are not listed in the table below are not supported.
| Object Type | Object Type | Object Type | Service Account Authentication Support Status | App Profile Support Status | Comment |
|---|---|---|---|---|---|
| Mailbox | User Mailbox | User Mailbox | √ | √ | User mailboxes cannot be migrated to Microsoft 365 Group mailboxes.The mailbox cannot be migrated to the destination if the user is Suspended or Archived. Mailbox delegations/permissions are not supported for migration. |
| Mailbox | Resource Mailbox | Resource Mailbox | Partially Supported | Partially Supported | Resource mailboxes cannot be migrated to Microsoft 365 Group mailboxes and Archive mailboxes.The following properties of events may not be migrated to the destination:● The event’s color cannot be migrated to the destination because the Exchange calendar does not have the color property.● The event’s notification time cannot be migrated to the destination, and the destination Reminder’s default time (15 mins) will be displayed for the migrated events.● If the source event takes place during the time switch between the Daylight Saving Time (DST) and the Standard Time of the source time zone, the event time may not be correctly migrated to the destination.● If the destination Exchange is configured with a maximum booking lead time (days) for resource mailboxes and the meeting end date of the source event is later than the destination booking lead time, the event can be migrated, however, the event will be automatically cancelled after the event organizer updates the event in the destination. ● If the destination Exchange is configured with a maximum event duration for resource mailboxes and the meeting duration of the source event exceeds the maximum destination duration, the event can be migrated; however, the event will be automatically canceled after the event organizer updates the event in the destination. |
| Folder | Inbox | Inbox | √ | √ | |
| Folder | Sent | Sent | √ | √ | |
| Folder | All Mail | All Mail | × | × | The All Mail folder is a virtual folder where all mails can be viewed. |
| Folder | Starred | Starred | Partially Supported | Partially Supported | The Starred label will not be migrated as a folder in the destination. Mails in the Starred label will be marked as a flag (.png "('image1', 'The Flag mark')")) in the destination. For example, if a source mail in the Inbox folder has been added to the Starred label, it will be migrated to the Inbox folder and will be marked as a flag (.png "('image2', 'The Flag mark')")) in the destination. |
| Folder | Drafts | Drafts | √ | √ | |
| Folder | Archive Folder | Archive Folder | √ | √ | To view your archived items in the Archive folder, you can enter has:nouserlabels -label:Inbox -label:sent -label:spam -label:chats -label:drafts -label:trash -label:social -label:promotions -label:updates -label:forums -in:scheduled in the Gmail Search mail text box. |
| Folder | Spam | Spam | √ | √ | |
| Folder | Trash | Trash | √ | √ | |
| Folder | Snoozed | Snoozed | × | × | |
| Folder | Important | Important | Partially Supported | Partially Supported | The Important label will not be migrated as a folder in the destination. Mails in the Important label will be marked as important (.png "('image3', 'The Important mark')")) in the destination. For example, if a source mail in the Inbox folder has been added to the Important label, it will be migrated to the Inbox folder and will be marked as important (.png "('image4', 'The Important mark')")) in the destination. |
| Folder | Custom Label | Custom Label | √ | √ | Select Migrate labels as folders in the migration policy to migrate source mails with multiple labels to different folders based on the labels, which would result in duplicate mails in the destination. This option will keep the source folder structure.Select Migrate labels as categories in the migration policy to migrate source mails with custom labels to the destination "Inbox" folder and apply a category with the same name as the source custom label to the migrated mails. |
| Folder | Chats | Chats | × | × | |
| Folder | Scheduled | Scheduled | Partially Supported | Partially Supported | Scheduled mails can be migrated to the destination Scheduled folder, while the schedule settings cannot be migrated. |
| Folder | Category | Category | Partially Supported | Partially Supported | Only the Social/Updates/Forums/Promotions labels and mails with these labels are supported in the migration. |
| Item | √ | √ | The source muted mails cannot be retrieved and migrated due to source Google API limitations.Due to destination API limitations, emojis in the source mail body may not be correctly displayed in the destination after the migration. Mail attachments can be migrated to the destination. Note the following:In the source, if an attachment uploaded to the mail exceeds 25 MB, Gmail will save the attachment to the user’s Google Drive and leave a link to the attachment; If an attachment is inserted to the mail from Google Drive, Gmail will display the attachment as a link. | ||
| After the mail is migrated to the destination, the attachment link in the mail is migrated to the destination and can be directed to the attachment in Google Drive. | |||||
| Item | Calendar | Calendar | Partially Supported | Partially Supported | The Other Calendars are not supported in the migration.If you have the Make changes and manage sharing permission to primary calendars shared by others, these primary calendars cannot be migrated.The calendar cannot be migrated to the destination if the user is Suspended or Archived.The information of the meeting room will be migrated to the meeting body in the destination.The out of office/focus time events are not supported in the migration.The following properties of events may not be migrated to the destination:● The event’s color cannot be migrated to the destination because the Exchange calendar does not have the color property.● If the source event takes place during the time switch between the Daylight Saving Time (DST) and the Standard Time of the source time zone, the event time may not be correctly migrated to the destination. |
| Item | Task | Task | √ | √ | The tasks whose Titles and Details are empty will not be migrated.Subtasks of tasks will be migrated to tasks because the destination Exchange task does not have the corresponding property.The Repeat property value of the task cannot be migrated due to the limitations of Google API.The task cannot be migrated to the destination if the user is Suspended or Archived. |
| Item | Chat | Chat | × | × | |
| Item | Contacts | Contacts | Partially Supported | Partially Supported | Refer to the notes under this table. |
| Item | Other contacts | Other contacts | × | × | |
| Item | Contacts Labels | Migrate to Contact Group/Contact List | √ | √ | When migrating to Exchange Online, the contact labels whose contact email address is empty can be migrated, but the contact without an email address cannot be migrated to the destination Contact Group since the contact cannot be created in Exchange Online. |
| Item | Google Group | Migrate to Microsoft 365 Group | Partially Supported | Partially Supported | Google groups that have All users in the organisation as members/owners/managers cannot be migrated to the destination.The Manager role of Google Groups will be migrated as the Member role.The owners, managers, members, display names, and notes of Google Groups can be migrated. The managers of Google groups will be migrated as members of distribution groups in the destination. |
| Item | Google Group | Migrate to Distribution Group | Partially Supported | Partially Supported | Google groups that have All users in the organisation as members/owners/managers cannot be migrated to the destination.The Manager role of Google Groups will be migrated as the Member role.The owners, managers, members, display names, and notes of Google Groups can be migrated. The managers of Google groups will be migrated as members of distribution groups in the destination. |
| Item | Google Group | Migrate to Mail-enabled Security Group | Partially Supported | Partially Supported | Google groups that have All users in the organisation as members/owners/managers cannot be migrated to the destination.The Manager role of Google Groups will be migrated as the Member role.The owners, managers, members, display names, and notes of Google Groups can be migrated. The managers of Google groups will be migrated as members of distribution groups in the destination. |
| Item | Google Group | Google Group Conversation | × | × | |
| Hold Data in Google Workspace | Hold Data in Google Workspace | Hold Mail | × | × | |
| Hold Data in Google Workspace | Hold Data in Google Workspace | Google Group Conversation | × | × | |
| Gmail Setting | Filter | Filter | Partially Supported | Partially Supported | Refer to the Gmail Filter to Inbox Rule Mappings section to view the Gmail filter to Exchange inbox rule mappings. |
*Note: The inbox rules can be migrated when the source is not a resource mailbox and the destination is not an archive mailbox.
*Note: The data size will be reduced when the source Gmail data is migrated to the destination Exchange due to the different data storage methods.
*Note: When the source email configures the Confidential mode, after the migration, the email content cannot be displayed, and the email will contain a link in the destination. Recipients can click the link and log in to their Google accounts to view the email content when the source sender is online.
*Note: While migration is in progress, for calendar invites, having an organizer at the Microsoft 365 side while some attendees at the Gmail side and with proper forwarding setup, the update or cancellation by the organizer cannot be synchronized to those attendees' Gmail calendars although attendees at the Gmail side do receive the emails triggered by the update or cancellation.
When migrating Gmail contacts, note the following issues.
If the birthday value of the contact is in the Time format, such as mm/dd/yyyy HH:mm:ss, yyyy-mm-dd HH:mm:ss, and yyyymmddHHmmss, the birthday can be migrated, but only the birthday date can be displayed in the destination.