---
schema_version: "1"
id: e68752e13e0113d396b1a678a9f231e0ee169dad6d29b31a1e4acc3b0725e427
title: Migrate Custom Labels 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/legacy_to_enhanced_migration_labels.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.legacy_to_enhanced_migration_labels.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6882bfb26658d16c84dd649c4a97c7241b24f8a430d4b6bca1cf071051d727d9
description: Some Legacy Chat labels are migrated to Enhanced Chat with the Legacy Web Chat Migration (Beta) tool. Review which labels come over automatically. Then review which labels you can customize manually once you set up Enhanced Chat.
products:
  - Service Cloud
  - Digital Engagement
release: "264"
---
# Migrate Custom Labels from Legacy Chat to Enhanced Chat

Some Legacy Chat labels are migrated to Enhanced Chat with the Legacy Web Chat Migration (Beta) tool. Review which labels come over automatically. Then review which labels you can customize manually once you set up Enhanced Chat.

### 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="legacy_to_enhanced_migration_labels__d673e1065"><!-- --></a><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" id="legacy_to_enhanced_migration_labels__d673e1065" 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="d47279e93">User Permissions
            Needed</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d47279e93 ">To set up this feature:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d47279e93 ">
            <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="d47279e93 ">To modify permission sets and profiles:</td>

          <td class="slds-cell-wrap" style="vertical-align:top;" headers="d47279e93 ">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.

Some Legacy Chat labels are migrated directly to Enhanced Chat labels when you go through the Legacy Web Chat Migration (Beta) tool. To translate these labels into more than one language, run through the tool, and select a different language each time. To customize these migrated labels as well as [other Enhanced Chat labels](https://help.salesforce.com/s/articleView?id=service.miaw_custom_labels.htm&type=5&language=en_US), use the [Set Custom Labels editor](https://help.salesforce.com/s/articleView?id=service.miaw_configure_web_deployment_1.htm&type=5&language=en_US) in Embedded Service Deployment Settings.

## Labels that are Migrated to Enhanced Chat

These Legacy Chat labels are migrated directly to Enhanced Chat labels when you go through the Legacy Web Chat Migration (Beta) tool.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
      <thead class="slds-text-title_caps ">
        <tr><th class="slds-cell-wrap" scope="col" id="d47279e158">Legacy Chat Label</th>
        <th class="slds-cell-wrap" scope="col" id="d47279e161">Label Location</th>
        <th class="slds-cell-wrap" scope="col" id="d47279e164">Enhanced Chat Label</th>
        <th class="slds-cell-wrap" scope="col" id="d47279e167">Label Location</th>
      </tr></thead>
      <tbody><tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Close Dialog</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">General</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Close the message window</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">All</strong> | <strong class="uicontrol">Accessibility</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Minimize chat</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">General</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Minimize chat window</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">All</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Start Chatting</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Prechat</strong> | <strong class="uicontrol">All</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Start Conversation</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">Pre-Chat Form</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">I accept</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">All</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">I accept</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">Pre-Chat Form</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">This field is required.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">All</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">This field is required.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">Terms and Conditions</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">[No default label. This is the label for your Terms and Conditions
          acceptance.]</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">Terms and Conditions</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">[No default label. This is the label for your Terms and Conditions
          acceptance.]</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Pre-Chat</strong> | <strong class="uicontrol">Terms and Conditions</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Chat Ended by Agent</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Agent ended the chat at</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong> | <strong class="uicontrol">System Messages</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Chat Ended</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">You ended the chat at</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong> | <strong class="uicontrol">System Messages</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Conversation Ended by Bot</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Bot ended the chat at</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Ended</strong> | <strong class="uicontrol">System Messages</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Type your message...</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Body</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Type your message...</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Input Footer</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Please wait. Reconnecting</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Reconnecting</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Reconnecting...</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">All</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Reconnecting</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Minimized</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Reconnecting...</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Minimized</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Transferring</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Minimized</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Transferring...</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Header</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Chat ended</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Minimized</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Chat Ended</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Minimized</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">1 Message</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Minimized</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">New message</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Minimized</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">{0} Messages</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Minimized</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">New messages</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Minimized</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Upload a file</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">
          <p>Attach file</p>
        </td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Remove this file.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Don't send file {0}</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Select a file under {0}mb</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">These files exceed the {1} MB limit: {0}. Try again.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">File Transfer</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Thanks for chatting with us. Ask me anything.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Header</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Hello, ask me anything.</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Header</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Save Transcript</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Body</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Request Chat Transcript</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">General</strong> | <strong class="uicontrol">Header</strong> | <strong class="uicontrol">Standard</strong></span></td>
      </tr>
      <tr class="">
        <td class="slds-cell-wrap" data-label="Legacy Chat Label" headers="d47279e158">Choose one of the following options</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e161"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Einstein Bots</strong></span></td>
        <td class="slds-cell-wrap" data-label="Enhanced Chat Label" headers="d47279e164">Select a menu item</td>
        <td class="slds-cell-wrap" data-label="Label Location" headers="d47279e167"><span class="menucascade"><strong class="uicontrol">Chat in Progress</strong> | <strong class="uicontrol">Chat Body</strong> | <strong class="uicontrol">Accessibility</strong></span></td>
      </tr>
    </tbody></table>

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