---
schema_version: "1"
id: 551f556070a9842064c4d6ec946625c0ad7ed3410682573b50a0896c949bf071
title: Troubleshooting Custom Lightning Types in Enhanced Chat v2
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/enhanced_chat_v2_lt_troubleshoot.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.enhanced_chat_v2_lt_troubleshoot.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6db26061a85714ea2f4098b024261de898fa46511f80f08f5ceb04265aac851c
description: Solve common issues with rendering custom Lightning types in Enhanced Chat v2.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Troubleshooting Custom Lightning Types in Enhanced Chat v2

Solve common issues with rendering custom Lightning types in Enhanced Chat v2.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition">
      <colgroup>
        <col>
      </colgroup>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td>

        </tr>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and
            <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required
              add-on licenses vary by agent type.</a>
          </td>

        </tr>
        <tr class="">
          <td class="slds-cell-wrap" style="vertical-align:top;">
            <p><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/resources-global/_corporate/images/checkmark.png" alt="Check mark"></span>This article applies to: Agentforce Service agents</p>
            <p><span style="vertical-align:text-bottom;display:inline-block;"><img style="margin-bottom:0;" src="https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/resources-global/_corporate/images/crossmark.png" alt="Cross mark"></span>This article doesn't apply to: Agentforce Employee agents</p>
            <p style="margin-bottom:0;">To learn about channel support for other agent types, see the documentation for
              that type.</p>
          </td>

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

Before you begin, test your custom Lightning type with the Enhanced Chat v2 connection in [Agentforce Builder preview](https://help.salesforce.com/s/articleView?id=ai.agent_test_in_builder.htm&release=264.0.0&type=5 "Manually testing your agent in Agentforce Builder provides a detailed, step-by-step trace of your agent's interactions and processes. Use the Preview panel to chat with your agent, then review subagent selection, action execution, and reasoning on the Interaction Summary panel. For more details about any step, converse with the Agentforce Assistant."). If a custom Lightning type doesn't render in the preview, troubleshoot the agent's Agent Script. See [Agentforce Developer Guide: Get Started with Agent Script](https://developer.salesforce.com/docs/ai/agentforce/guide/agent-script.html).

If your custom Lightning types still don't render, verify these settings.

- On the Session Settings Setup page, make sure that Use Lightning Web Security for Lightning web components and Aura component is enabled.
- In Agentforce Builder, make sure that the agent user has access to the objects and fields that the custom Lightning type uses.
- In Agentforce Builder, make sure that the output of the agent action that uses the custom Lightning type has the correct component and has **Show in conversation** selected.

After your custom Lightning types render consistently in the preview, activate your agent and republish your embedded service deployment.

## My custom Lightning types don't render.

To make sure that custom Lightning types render completely, republish your embedded service deployment after you:

- Add a new agent in your Omni-Channel routing flow or change the agent in your messaging channel's Omni-Channel routing settings
- Add new actions to your agent
- Edit the inputs or outputs for existing actions
- Change the output rendering type for any output
- Activate a different version of your agent

## My custom Lightning types render as text.

If you see a text response instead of the expected custom Lightning types, verify these settings.

- In Agentforce Builder, make sure that your agent has the Enhanced Chat v2 connection.
- On the Embedded Service Deployment Setup page, confirm that your embedded service deployment is v2, not v1.
- Make sure that the Agent User profile and the System Administrator profile have access to the invocable Apex classes and flows. See [Set Apex Class Access from Profiles](https://help.salesforce.com/s/articleView?id=platform.users_profiles_apex_access.htm&type=5&language=en_US) and [Provide Access to Use Flows](https://help.salesforce.com/s/articleView?id=ind.retail_task_admin_permission_flow.htm&type=5&language=en_US).

If you created an agent in the legacy builder that's connected to Telephony and Enhanced Chat v2, custom Lightning types can render as text.

## My custom Lightning types don't render for Experience Cloud site users.

Salesforce creates an embedded service site when you create an embedded service deployment. When a signed-in user is a member of both sites, Enhanced Chat v2 passes that user's access to the custom Lightning types in the chat.

If a custom Lightning type doesn't render for signed-in users, give your embedded service site the same members as your Experience Cloud site. See [Run Custom Components as the Logged-In User in Enhanced Web Chat](https://help.salesforce.com/s/articleView?id=service.miaw_custom_component_user_context.htm&type=5&language=en_US).

#### See Also

- [Troubleshoot Enhanced Chat Setup](https://help.salesforce.com/s/articleView?id=service.miaw_troubleshoot.htm&language=en_US)
- [_Agentforce Developer Guide_: Customize the Agent Action UI with Lightning Types](https://developer.salesforce.com/sample-apps/agent-script-recipes/action-configuration/custom-lightning-types)
- [_Agent Script Recipes_: CustomLightningTypes](https://developer.salesforce.com/sample-apps/agent-script-recipes/action-configuration/custom-lightning-types)