---
schema_version: "1"
id: 7892e9905bda4c0e0b7df1e3c3257a63e6eaa61a3c86e882af6b7496da50d28d
title: Migrate from Legacy Chat to Enhanced Chat
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/lc_migrate_3.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.lc_migrate_3.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 199c0158e85da7b26ce105fb4f23a9b5b8139fec873c1de376939b8e99defcfc
description: Set up a domain where you’ll host Enhanced Chat. Use the Legacy Web Chat Migration (Beta) tool to migrate to Enhanced Chat. And then take the required and optional next steps after using the tool.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Migrate from Legacy Chat to Enhanced Chat

Set up a domain where you’ll host Enhanced Chat. Use the Legacy Web Chat Migration (Beta) tool to migrate to Enhanced Chat. And then take the required and optional next steps after using the tool.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;type=5&amp;language=en_US" target="_blank">View supported editions.</a></td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <a name="lc_migrate_3__d512e1065"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="lc_migrate_3__d512e1065" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/checkmark.png" alt="Checkmark"></span>
              <strong>This article applies to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced Web Chat channels</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">
              <span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/resources-global/_corporate/images/crossmark.png" alt="X icon"></span>
              <strong>This article doesn’t apply to:</strong>
            </td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Enhanced In-App Chat, Enhanced WhatsApp, Enhanced Facebook Messenger, Standard
              and Enhanced SMS, Enhanced Apple Messages for Business, Enhanced LINE, and Bring Your
              Own Channel</td>

          </tr>
        </tbody>
      </table> <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d37025e97">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d37025e97 ">To set up this feature:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d37025e97 ">
              <p>Customize Application </p>
              <p style="margin-bottom:0;">AND</p>
              <p style="margin-bottom:0;">Modify Metadata Through Metadata API Functions</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d37025e97 ">To modify permission sets and profiles:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d37025e97 ">Manage Profiles and Permission Sets</td>

          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_channels-264-0-0-production-enus/f3c4b3d2-ff86-4f7c-9fe2-3d8b23d35109/images/icon_note.png)

Note Beginning in June 2025, Messaging for In-App and Web is changing its name to Enhanced Chat. During this transition, you can possibly see references to both names in our documentation. We wish we could magically update the name everywhere at once, and we thank you for your patience as we evolve.

#### See Also

- [_Trailhead_: Migrating from Legacy Chat to Enhanced Chat](https://trailhead.salesforce.com/content/learn/modules/migrating-from-legacy-chat-to-enhanced-chat)
- [Enhanced Chat FAQ](https://help.salesforce.com/s/articleView?id=service.miaw_faq.htm&release=264.0.0&type=5 "Review answers to commonly asked questions about Enhanced Chat, formerly Messaging for In-App and Web.")

## Pre-Work Before Using the Migration Tool

The migration tool asks for a domain where you'll host Enhanced Chat. It's not possible to host both a Legacy and Enhanced Chat deployment on the same page, so remove your chat widget before migration. To test your Enhanced Chat workflow before going live, consider entering a sandbox as the domain

## Use the Legacy Web Chat Migration (Beta) Tool

Now that you completed the pre-work, migrate Legacy Chat to Enhanced Chat.

1. In Setup, in the Quick Find box, enter Legacy and select **Legacy Web Chat Migration (Beta)**.
2. Click **Get Started**.
3. First, tell us which type of Legacy Chat you have. Are you using Embedded Service (formerly known as Snapins) to expose chat to your customers? If the term Embedded Service doesn’t sound familiar, [learn more here](https://help.salesforce.com/s/articleView?language=en_US&id=service.snapins_chat_overview.htm&type=5). Your answer to this question determines the remaining fields that appear on the page.
    1. If you select **Yes**, add your Embedded Chat Deployment. Under Deployment Type, if you select **New Enhanced Web Chat Deployment**, name your deployment, give it an API name, and add your domain. To map it to a new messaging channel, give it a name and developer name. To map it to an existing messaging channel, search for and select the channel. If you instead select **Existing Enhanced Web Chat Deployment** under Deployment Type, select your deployment and then choose a single language for your migrated custom labels. To migrate eligible Legacy Chat custom labels in more than one language, run through the migration tool again for each additional language.
    2. If you select **No**, add your Chat Deployment and Chat Button. We’ll create a new Embedded Service Deployment during migration. Name your deployment, give it an API name, and add your domain. To map it to a new messaging channel, give it a name and developer name. To map it to an existing messaging channel, search for and select the channel.
4. Click **Next**.
5. On the Next Steps page, review the information, and click **Save**.
6. On the final page, a progress indicator lets you know that your deployment is migrating. Don’t navigate away from this page until the migration is complete. This can take up to 10 minutes.
7. When migration is complete, you're presented with the Embedded Service Deployment Settings page. Customize your deployment before copying the code snippet to embed on your website. Republish your deployment after making any changes in the Settings page. [Learn more about configuring your deployment](https://help.salesforce.com/s/articleView?id=service.miaw_optimize_setup.htm&type=5&language=en_US) or [making additional enhancements](https://help.salesforce.com/s/articleView?id=service.messaging_productivity.htm&type=5&language=en_US) to the Enhanced Chat experience.

## Required Next Steps After Using the Migration Tool

The Legacy Web Chat Migration (Beta) tool migrates your queue to Enhanced Chat if you select the option to create a messaging channel in the process. To make the queue work in Enhanced Chat, add Messaging User and Messaging Session as supported objects to the Queue.

1. From Setup, in the Quick Find box, enter Queues, and then select **Queues**.
2. Click the name of your queue.
3. Click **Edit**.
4. Under Supported Objects, use the arrow to move Messaging User and Messaging Session from Available Objects to Selected Objects.
5. Save your changes.