---
schema_version: "1"
id: 93eda29e1a64bbb2c7530f4f6a80d733eb9486ba7901f23a69cce88bd5518f13
title: Configure a Tableau Pulse Lightning Web Component
collection: tableau
version: current
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/current/en-gb/online/lwc_tableau_pulse.md
canonical_url: https://help.tableau.com/current/online/en-gb/lwc_tableau_pulse.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 67c1798c2d95abc55f76219de665105b5253feafc03f6991e18b97929a79b8f1
description: Configure a Tableau Pulse Lightning web component on Salesforce Lightning pages.
---
[Skip to main content](#main-content)

# Configure a Tableau Pulse Lightning Web Component

The Tableau Pulse Lightning web component (LWC) allows Salesforce customers to drag and drop embedded Tableau Pulse metrics from Tableau Cloud onto Salesforce Lightning pages. Tableau Pulse LWC supports embedding on App, Home and Record pages, as well as Experience Cloud and the Salesforce Utility Bar.

For instructions to turn on a Tableau LWC, add a trusted URL, set up seamless authentication and host mapping and add a component to a Lightning page, see [Configuring Tableau Lightning Web Components](https://help.tableau.com/current/online/en-gb/lwc_seamless_auth.htm).

When you’ve added a Tableau Pulse LWC to your Lightning page, configure the component fields.

Component fieldDescription<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>Component field</strong></td><td><strong>Description</strong></td></tr><tr><td>Tableau Pulse URL</td><td>This field is required. Enter the URL for the Tableau Pulse page or metric that you want to embed.</td></tr><tr><td>Site ID</td><td>This field is required for seamless authentication if there isn’t a host mapping specified for the URL used in the <strong>Tableau Pulse URL</strong> field. If a host mapping exists for the Tableau site, the contents of this field are ignored.</td></tr><tr><td>Height</td><td>Height in pixels. When set to the default value of 0, height adjusts automatically to best fit the selected layout.</td></tr><tr><td>Layout</td><td>Determines the size and level of detail displayed. Choose from Full, Compact or Mini.</td></tr><tr><td>UAF Definition Names</td><td><p><strong>App, Home and Record pages</strong></p><p>Select from UAF claim definitions configured in the Tableau UAF Claims Definition settings.</p><p>To add a definition:</p><ol><li value="1"><p>Select <span class="uicontrol">Select…</span>.</p></li><li value="2"><p>Use the arrows to move available definitions to the <span class="uicontrol">Selected </span>field.</p></li><li value="3"><p>Select <span class="uicontrol">OK</span>.</p></li></ol><p><strong>Experience Cloud pages and the Salesforce Utility Bar</strong></p><p>Enter a comma-separated list of UAF claim definition names. To copy definition names, from the Salesforce app, navigate to the<span class="uicontrol"> Tableau UAF Claims Definition</span> setup page and select <span class="uicontrol">Copy</span>.</p></td></tr><tr><td>Debug Mode</td><td>Tick the box to turn on debug mode.</td></tr><tr><td>Force refresh toggle</td><td>When troubleshooting, you can toggle this tick box to refresh only this component instead of refreshing the whole Lightning App Builder Page or all components on the Lightning Page.</td></tr><tr><td>Set Component Visibility: Filters</td><td><p>Create filters for when to display the component. For example, you can filter on a specific user, permissions or device form factor.</p><p>To add a filter:</p><ol><li value="1">Select <span class="uicontrol">Add Filter</span>.</li><li value="2">Choose <span class="uicontrol">Select </span>to pick a field to filter on.</li><li value="3">Complete your selection, and then select <span class="uicontrol">Done</span>.</li><li value="4">Select <span class="uicontrol">Done </span>to save your filter.</li></ol><p><strong>Important</strong>: You must enter field names as they are defined in the data source. For example, if the data source is in English, but the data source fields are translated to Japanese for a user, the user must enter the original English field name.</p></td></tr><tr><td>Static Filters</td><td>Add static filters to the Tableau Pulse metric (for example, Region=North).</td></tr></tbody></table>

### Fields available only on Record pages

The following fields make it possible to dynamically filter on up to two fields. For example, you can filter on ‘Account ID’ using the tick box and ‘State/Province’ using the advanced filters.

Component fieldDescription

<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>Component field</strong></td><td><strong>Description</strong></td></tr><tr><td>Filter on Record ID</td><td>Used for dynamic filtering of the view using the Record ID. The name of the field in the data source for the pulse metric must match the format “Record Type ID” and is case sensitive. For example, if the Lightning page is for Account records, the field in the pulse metric must be named “Account ID”.</td></tr><tr><td>Tableau Dynamic Filter Name</td><td>Used for dynamic filtering using a specific field from the current record. Enter the name of the field in the data source for the pulse metric.</td></tr><tr><td>Salesforce Dynamic Filter Value</td><td>Used for dynamic filtering using a specific field from the current record. Select the corresponding field on the Salesforce record.</td></tr></tbody></table>

## Tableau Pulse component troubleshooting

From the page that contains the Tableau Pulse Lightning web component, select the gear icon, and then select Edit Page.

1. Click on the Tableau Pulse Lightning web component to open the property editor.
2. Confirm that the **Tableau Pulse URL** field contains a valid URL for a Tableau Pulse page or metric.
3. Verify that the **Site ID** field is populated with the Site ID for the Tableau site. To find the Site ID, open the Share dialogue for the workbook or view from the Tableau site.

For other Tableau LWC and seamless authentication information and troubleshooting, see [Configuring Tableau Lightning Web Components](https://help.tableau.com/current/online/en-gb/lwc_seamless_auth.htm).