---
schema_version: "1"
id: 6faf53670776d56423747236c02a131000c0db9b08c2f2bef2dd5ab0fe6c1f79
title: Add Custom Lightning Web Components to Lightning Dashboards
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/dashboards_embed_lwcs.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.dashboards_embed_lwcs.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5b924f77fff6da64aadf6126f9df68282bc2f0c46d806efe2f2b6c40a0c4611e
description: Use custom Lightning Web Components (LWCs) in Lightning dashboards to add meaningful visual context and support new use cases. Custom LWCs provide interactive, real-time data views that go beyond standard dashboard capabilities. For example, you can add an LWC to display a waterfall chart, which isn’t available in standard dashboard components.
products:
  - Cross Cloud
release: "264"
---
# Add Custom Lightning Web Components to Lightning Dashboards

Use custom Lightning Web Components (LWCs) in Lightning dashboards to add meaningful visual context and support new use cases. Custom LWCs provide interactive, real-time data views that go beyond standard dashboard capabilities. For example, you can add an LWC to display a waterfall chart, which isn’t available in standard dashboard components.

### 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: Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions</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="d16977e62">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d16977e62 ">To add custom Lightning Web Components in dashboards</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d16977e62 ">Run Reports AND Create and Customize Dashboards</td>

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

1. Click **+Widget** to add a dashboard widget, or edit an existing one by clicking the pencil icon on the widget.
2. Click **Lightning Web Component**.
3. Select the Lightning web component to add to your dashboard.
4. Configure the parameters for the LWC. Optionally, you can set a widget theme for the LWC.
5. Click **Add** to add the LWC to the dashboard.
    
    The LWC data is shown based on the permissions of the logged-in user.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-analytics-264-0-0-production-enus/295fead5-b71d-4e1c-9886-4af4d53400b6/images/icon_note.png)

Note You can add only one custom Lightning Web Component (LWC) to a dashboard.

#### See Also

- [Lightning Web Components in CRM Analytics Dashboards and Lightning Dashboards](https://developer.salesforce.com/docs/analytics/bi-dev-guide-lwc-in-db/guide/bi-lwc-in-db-overview.html)