---
schema_version: "1"
id: 3b0ef70f496aa8468330a673eaca1e38e48528729ced2e34d2c0f1a664354cdc
title: Embed Code Parameters for Views
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/pro/desktop/embed_list.md
canonical_url: https://help.tableau.com/current/pro/desktop/en-us/embed_list.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 9c88c82b5f4158386181dbf37b2bd2913bc58dfe1dc0b370f49963d77cf7d4b0
description: The embed code for Tableau Server 2022
---
[Skip to main content](#main-content)

# Embed Code Parameters for Views

> [!TIP]
> 
> The embed code for Tableau Server 2022.3 and later and Tableau Cloud has changed to use the Embedding API v3. For a current list of classes and methods in the Embedding API v3, see the [Embedding API Reference](https://help.tableau.com/current/api/embedding_api/en-us/reference/index.html) in the [Embedding API help](https://help.tableau.com/current/api/embedding_api/en-us/index.html). The information in this topic is for prior versions of embedding (using the Tableau JavaScript API v1 and v2).

Parameters for prior versions of embedding

You can configure an embedded view using either of these methods:

- [Object parameters for JavaScript tags](#Object_params)
- [URL parameters for iframe tags](#URL_params)

## Object parameters for JavaScript tags

<table class="table--plain">
                            <thead>
                                <tr class="TableStyle-Basic-Border-Head-Header1">
                                    <th>Object Parameter</th>
                                    <th>Values</th>
                                    <th>Description</th>
                                    <th>Examples</th>
                                </tr>
                            </thead>
                            <tbody>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>dataDetails</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Data Details button in the toolbar, which lets users see details about the data used in that view. </td>
                                    <td><code>&lt;param name='dataDetails' value='no' /&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>showDataDetails</code>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>If Tableau Catalog is enabled, shows the view with the Data Details pane open.</td>
                                    <td><code>&lt;param name='showDataDetails' value='yes' /&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>alerts</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Alerts button in the toolbar, which lets users create data-driven alerts. </td>
                                    <td><code>&lt;param name='alerts' value='no'/&gt;</code>
                                        <br>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>customViews</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the View button in the toolbar, which lets users save custom views.</td>
                                    <td><code>&lt;param name='customViews' value='no'/&gt;</code>
                                        <br>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>device</code>
                                    </td>
                                    <td><code>desktop; tablet; phone</code>
                                    </td>
                                    <td>If a dashboard has layouts for mobile devices, displays a specific layout, regardless of screen size. If this parameter isn't set, Tableau Server or Tableau Cloud  detects screen size and loads a corresponding layout. See <a href="https://help.tableau.com/current/pro/desktop/en-us/embed_dashboard.htm" class="xref">Embed Dashboards</a> for examples.</td>
                                    <td><code>&lt;param name='device' value='phone'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>filter</code>
                                    </td>
                                    <td>string</td>
                                    <td>Filters the data displayed when the view
opens. You can also filter  using URL parameters.</td>
                                    <td><code>&lt;param name='filter' value='Team=Blue'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>host_url</code>
                                    </td>
                                    <td>string</td>
                                    <td>Required. The server name as it appears in the URL.</td>
                                    <td><code>&lt;param name='host_url' value='http://myserver.exampleco.com/'&gt;</code>
                                        <p><code>&lt;param name="host_url" value="http://localhost/"&gt;</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>linktarget</code>
                                    </td>
                                    <td>string</td>
                                    <td>The target window name for external hyperlinks. </td>
                                    <td><code>&lt;param name="linktarget" value="_blank"/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>load-order</code>
                                    </td>
                                    <td>number</td>
                                    <td>When multiple views are embedded, determines the order in which they load on the page. Negative numbers are allowed. </td>
                                    <td><code>&lt;param name="load-order" value="2"/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>mobile</code>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>Displays touch-optimized quick filters for mobile devices.</td>
                                    <td><code>&lt;param
						name='mobile' value='yes'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>name</code>
                                    </td>
                                    <td>string</td>
                                    <td>Required object parameter, with this structure: [workbook name]/[sheet name]/[optional custom view name]<p> Format optional custom view names like this: username@domain/[custom
view name]<br><br>If you refer to the Tableau Server or Tableau Cloud URL to confirm the value of <code>name</code>, exclude the session ID (<code>:iid=<i>&lt;n&gt;</i></code>) at the end of the URL.</p></td>
                                    <td><code>&lt;param name='name' value='ExampleCoSales/Sales'/&gt;</code>
                                        <p><code>&lt;param
name='name' value='ExampleCoSales/Sales/jsmith@example.com/EastRegionSales'/&gt;</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:original_view</code>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>If the <code>name</code> parameter refers to a workbook or sheet URL (and does not explicitly refer to a custom view) including this parameter displays the view as the original view. </td>
                                    <td><code>&lt;param name='filter' value=':original_view=yes'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>path</code>
                                        <p>(Tableau Server only. Not applicable to Tableau Cloud.)</p>
                                    </td>
                                    <td>string</td>
                                    <td>For trusted authentication only, cannot be
used with the <code>ticket</code> parameter. Overrides value of the <code>name</code> parameter
and is used as the URL. For more information, see <a href="https://help.tableau.com/current/server/en-us/trusted_auth_webURL.htm" target="_blank">Display the View with the Ticket</a> in the Tableau Server Administrator help.</td>
                                    <td><code>&lt;param name='path' value='trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4'/&gt;</code>
                                        <p><code>http://tableauserver/trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>showShareOptions</code>
                                    </td>
                                    <td><code>true</code>; <code>false</code></td>
                                    <td>Controls whether the Share options are displayed in an embedded view.</td>
                                    <td><code>&lt;param name='showShareOptions' value='true' /&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>site_root</code>
                                    </td>
                                    <td>string</td>
                                    <td>Required. The site name. The Default site value
is null (<code>value=''</code>). If your server is multi-site and
you want to use trusted authentication, see <a href="https://help.tableau.com/current/server/en-us/trusted_auth_webURL.htm" target="_blank">Display the View with the Ticket</a> in the Tableau Server help.</td>
                                    <td><code>&lt;param name='site_root' value='/#/Sales'/&gt;</code>
                                        <p><code>&lt;param name='site_root' value=''/&gt;</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>subscriptions</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Subscriptions button in the toolbar, which lets users set up email subscriptions to receive snapshots of views at regular intervals. </td>
                                    <td>
                                        <p><code>&lt;param name='subscriptions' value='no'/&gt;</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>tabs</code>
                                    </td>
                                    <td><code>yes; no</code>
                                    </td>
                                    <td>Displays or hides tabs.</td>
                                    <td><code>&lt;param name='tabs' value='yes'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>ticket</code>
                                        <p>(Tableau Server only. Not applicable to Tableau Cloud.)</p>
                                    </td>
                                    <td>string</td>
                                    <td>For trusted authentication only, cannot be
used with the <code>path</code> object parameter. Must be used with <code>name</code> object
to construct the trusted ticket redemption URL. For more information, see <a href="https://help.tableau.com/current/server/en-us/trusted_auth_webURL.htm" target="_blank">Display the View with the Ticket</a> in the Tableau Server help.</td>
                                    <td><code>&lt;param name='ticket' value='9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5'/&gt;</code>
                                        <p><code>http://tableauserver/trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code>
                                        </p>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>toolbar</code>
                                    </td>
                                    <td><code>yes; no; top</code>
                                    </td>
                                    <td>The toolbar is displayed on the bottom by default. The toolbar is placed above the view when you set this parameter to <code>top</code>and excluded from the embedded
view when you set it to <code>no</code>. </td>
                                    <td><code>&lt;param name='toolbar' value='top'/&gt;</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>tooltip</code>
                                    </td>
                                    <td><code>yes; no</code>
                                    </td>
                                    <td>Tooltips are displayed by default If you set this parameter to <code>no</code>, however, tooltips are excluded from the embedded
					view. </td>
                                    <td><code>&lt;param name='tooltip' value='no'/&gt;</code>
                                    </td>
                                </tr>
                            </tbody>
                        </table>

## URL parameters for iframe tags

Note: Before you add URL parameters, remove `:iid=[#]` at the end of the URL. This is a temporary view counter for your current browser session.

<table class="table--plain">
                            <colgroup><col>
                            <col style="width: 101px;">
                            <col>
                            <col>
                            </colgroup><thead>
                                <tr class="TableStyle-Basic-Border-Head-Header1">
                                    <th>URL Parameter</th>
                                    <th>Values</th>
                                    <th>Description</th>
                                    <th>Examples</th>
                                </tr>
                            </thead>
                            <tbody>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:dataDetails</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Data Details button in the toolbar, which lets users see details about the data used in that view.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:dataDetails=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:showDataDetails</code>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>If Tableau Catalog is enabled, shows the view with the Data Details pane open.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showDataDetails=yes</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:alerts</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Alerts button in an embedded view.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:alerts=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:customViews</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td><span class="uicontrol">Remember my changes</span> option.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:customViews=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:device</code>
                                    </td>
                                    <td><code>desktop; tablet; phone</code>
                                    </td>
                                    <td>
                        If a dashboard has layouts for mobile devices, displays a specific layout, regardless of screen size. If this parameter isn't set, Tableau Server or Tableau Cloud  detects screen size and loads a corresponding layout. See <a href="https://help.tableau.com/current/pro/desktop/en-us/embed_dashboard.htm" class="xref">Embed Dashboards</a> for examples.
                    </td>
                                    <td><code>http://tabserver/views/sales/sales_dashboard?:device=tablet</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:display_count</code>
                                        <p>(Tableau Public only)</p>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>Shows the total number of pageviews when you click the Tableau logo at lower left.</td>
                                    <td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:display_count=yes</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:embed</code>
                                    </td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>Required URL parameter. Hides the top navigation
area, better blending the view into your web page. </td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:format</code>
                                    </td>
                                    <td><code>pdf; png</code>
                                    </td>
                                    <td>Displays a view as a PDF or .png file.</td>
                                    <td><code>http://tabserver/views/Sales/Q2?:format=pdf</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:highdpi</code>
                                    </td>
                                    <td><code>false</code>
                                    </td>
                                    <td>Renders a view using standard DPI (dots per inch) for high-resolution displays and devices. </td>
                                    <td><code>http://tableauserver/views/Sales/Q2?:highdpi=false</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:linktarget</code>
                                    </td>
                                    <td>string</td>
                                    <td>The target window name for external hyperlinks. </td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:linktarget=_blank</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:openid_hd</code>
                                    </td>
                                    <td>string</td>
                                    <td>Used when authenticating with OpenID Connect. Specifies the hosted domain to which a user belongs. For example, you might use this option if you do not want to render the domain selection pane. Used in conjunction with <code>:openid_login_hint</code> to specify the full user identifier. </td>
                                    <td><code>http://tabserver/views/Sales/Q2?:openid_hd=example.com</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:openid_login_hint</code>
                                    </td>
                                    <td>string</td>
                                    <td>Used when authenticating with OpenID Connect. Specifies the full user identifier (email address). Used in conjunction with <code>:openid_hd</code> to specify the hosted domain to which the user belongs. </td>
                                    <td><code>http://tabserver/views/Sales/Q2?:openid_login_hint=tara@example.com</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td>:<code>record_performance</code><p>(Tableau Server only. Not applicable to Tableau Cloud.)</p></td>
                                    <td><code>yes</code>
                                    </td>
                                    <td>Starts a performance recording for a view. Add this at the end of the URL, immediately before the  session ID (<code>:iid=<i>&lt;n&gt;</i></code>). For more information, see <a href="https://help.tableau.com/current/server/en-us/perf_record_create_server.htm" target="_blank">Create a Performance Recording</a> in Tableau Server help.</td>
                                    <td><code>http://tabserver/views/Sales2013/Regions?:recordperformance=yes</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><a name="refresh_param"></a><code>:refresh</code>
                                    </td>
                                    <td> <code>yes</code></td>
                                    <td>Renders the view using the latest data from Tableau Server or Tableau Cloud. See <a href="https://help.tableau.com/current/pro/desktop/en-us/refresh.htm" class="xref">Refresh Data or Pause Automatic Updates</a> for details.<p class="note"><b>Tip:</b> To continually refresh a view, in the <code>&lt;head&gt;</code> section of the web page, add <code>&lt;meta http-equiv="refresh" content="#"&gt;</code>, where <code>#</code> is the number of seconds between refreshes.</p></td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:refresh=yes</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:render</code>
                                    </td>
                                    <td><code>true</code>; <code>false</code>; number</td>
                                    <td>
                        If client-side rendering is enabled (the default), setting this to <code>false</code> forces server-side rendering for the session. Setting this to  <code>true</code> forces client-side rendering for the session.
                        <p>A number from 1 to 100 can be entered to set the complexity threshold above which views are rendered by the server. For more information, see <a href="https://help.tableau.com/current/server/en-us/browser_rendering.htm" target="_blank">About Client-Side Rendering</a> in Tableau Server help.</p></td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:render=false</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:revert</code>
                                    </td>
                                    <td><code>all; filters; sorts; axes; shelves</code>
                                    </td>
                                    <td>Returns the item to its original state.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:revert=all</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:showAppBanner</code>
                                    </td>
                                    <td><code>false</code>
                                    </td>
                                    <td>Hides the “Open in Tableau Mobile” banner in mobile web browsers.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAppBanner=false</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:showAskData</code>
                                    </td>
                                    <td><code>false</code>
                                    </td>
                                    <td>Hides the Ask Data button in the toolbar in an embedded view. By default the Ask Data button displays.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAskData=false</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:showShareOptions</code>
                                    </td>
                                    <td><code>true</code>; <code>false</code></td>
                                    <td>Controls whether the Share options are displayed in an embedded view.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showShareOptions=true</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:showVizHome</code>
                                        <p>(Tableau Public only)</p>
                                    </td>
                                    <td><code>yes; no</code>
                                    </td>
                                    <td>Shows or hides the content navigation interface of Tableau Public. Set to no when embedding vizzes in other web pages.</td>
                                    <td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:showVizHome=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:subscriptions</code>
                                    </td>
                                    <td><code>no</code>
                                    </td>
                                    <td>Hides the Subscribe button in an embedded view.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:subscriptions=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:tabs</code>
                                    </td>
                                    <td><code>yes; no</code>
                                    </td>
                                    <td>Displays or hides tabs.</td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:tabs=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:toolbar</code>
                                    </td>
                                    <td><code>yes; no; top</code>
                                    </td>
                                    <td>The toolbar is displayed by default on the bottom when this parameter is not set. When <code>no</code> the toolbar is excluded from the embedded
view. When <code>top</code>, the toolbar is placed above the view. </td>
                                    <td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:toolbar=no</code>
                                    </td>
                                </tr>
                                <tr class="TableStyle-Basic-Border-Body-Body1">
                                    <td><code>:tooltip</code>
                                    </td>
                                    <td><code>yes; no</code>
                                    </td>
                                    <td>Tooltips are displayed by default in a view when this parameter is not set. If set to <code>no</code>, tooltips are excluded from the embedded
					view. </td>
                                    <td><code>http://tabserver/views/workbookQ4/SalesQ4?:embed=yes&amp;:tooltip=no</code>
                                    </td>
                                </tr>
                            </tbody>
                        </table>