I. Intro

Who can perform these steps: Primary administrators or administrators with "Mail" permission.

Feishu provides an email migration tool to help your organization migrate from its current business email service. 

II. Steps

Prepare for email migration

Before you migrate to Feishu Mail, make sure you have the following information. 

Information
Purpose
Domain administrator account 
Needed to log in to the domain service provider's website and adjust the DNS configuration.
Original email administrator account 
Needed to adjust the original email settings (may be required).
Any member's original email account and password 
Needed to ensure connectivity to the IMAP service and prepare for email migration.
Note: For more information on how to obtain the password for your original email account, see Obtain a dedicated app password in the original third-party email.
Member email list 
Used to create multiple member email addresses at once. It is important to match each member's email address with their respective mobile number.

Activate the email service and verify the domain

Enter the Feishu Admin Console and go to Product Settings > Mail > Service Management > Domain Management and click Set Up Now. 

In Configure domain, enter the email domain to be migrated and click Confirm. Then, select Enable email and migrate old emails and obtain the TXT-type DNS record(s).

After adding the DNS records to the original domain, click Verify Now on the Configure domain page. Feishu Admin Console will verify the DNS records. If successful, click Next to enter the Configure email migration parameters page.

Notice: After adding a DNS record, it takes some time for it to take effect, usually within 1 minute.

Enable email migration

On the Configure email migration parameters page, select the original email service provider that needs to be migrated. Fill in the information related to the original email service and click Enable Migration. 

Notice: Feishu will automatically set the relevant parameters based on the original email server selected. Generally, no additional settings are required. However, you can click Advanced Settings to manually set parameters. 

Assign email addresses to members

Important: To successfully migrate, do not click Next unless you have completed all the steps mentioned below.

Migrate members' mailboxes 

On the Email migration management page, you can assign email addresses to members who need to migrate. To begin, click Add Members.

In the Add Members pop-up window, select members who need to migrate their emails. 

After you've added members, click Configure now under the Original email address column to add the original email addresses of the members. If your organization is large, click Configure in batches.

After adding the email addresses of members, click Enable Migration to the right of a member to start email migration process for them. 

If you need to start email migration process for all members, click Status and select To be enabled. Then, click Enable All. 

Migrate public mailboxes

If you need to migrate a public mailbox, click Public mailboxes > Add Public Mailbox.

In the pop-up window that appears, select the public mailbox that needs to be migrated. 

If you want to create a new public mailbox for when you migrate to Feishu Mail, click Public mailbox. 

Fill in information about the new public mailbox. In Members, select a member who will complete the migration task for the public mailbox. 

After setting up the public mailbox that needs to be migrated, click Enable Migration on the right side of the public mailbox to start the migration.

Ask members to migrate

Next, you'll need to ask members to perform some migration steps through the Feishu app. To learn what members need to do,  see Migrate emails from a third-party email service to Feishu Mail. If members need to migrate a public mailbox, see Migrate a public mailbox.

Complete the migration process

After completing the above steps (this includes members' steps), on the Email migration management page, click Next in the upper-right corner. 

In the pop-up window, you'll be asked to confirm whether the current email migration process you've enabled is completed. The number of members and public mailboxes that have been migrated will be shown. 

Click OK to confirm email migration is completed.

You'll then enter the Activate Feishu Mail page. Follow the onscreen instructions to add MX and TXT (SPF) DNS records for the email domain. 

Important: Remove all existing MX and TXT (SPF) DNS records except those required for Feishu Mail.

After adding the DNS records according to the onscreen instructions, click Verify Now. Feishu will then verify the DNS records.

You can check the Status column to see whether the DNS records have been verified. Click Complete to proceed to the page where you will replace the domain name of your original email service. On that page, follow the onscreen instructions to complete the process of replacing the domain name of your original email service. To learn more about replacing domains, visit Guide on replacing domains.

After replacing the domain name, If the verification is successful, you will see that the status of the domain is Enabled, indicating email migration is complete.

Complete email tests

Next, perform the following email tests to ensure your email service is working properly:

Test sending and receiving emails between two email addresses with the same domain. For example, using the domain example.com, conduct a test where the email addresses thomas@example.com and angela@example.com send and receive emails to and from each other.

Test sending emails from an internal business email address to an external email address.

Test sending emails from an external email address to an internal business email address.

If you have an email address that uses a different domain provided by the original business email provider, test sending and receiving emails between that address and a Feishu business email address. If you don't have an email address with a different domain, you can skip this test.