---
schema_version: "1"
id: 1e445b8e06ba595bc2aeea77227982f8f92f029e1a2e3624238dbdbe33219ab0
title: Tableau JavaScript API
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/api/js_api/JavaScriptAPI/js_api.md
canonical_url: https://help.tableau.com/current/api/js_api/en-us/JavaScriptAPI/js_api.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f5b9a067fd1c59a9741c16dea8b36a6bfdedc984b8a309284cfed311ce240ac0
description: Important changes for the Tableau JavaScript API As of February 2024, the Tableau JavaScript API is deprecated
---
[Skip to main content](#main-content)

# Tableau JavaScript API

> [!WARNING]
> 
> **Important changes for the Tableau JavaScript API**  
> As of February 2024, the Tableau JavaScript API is deprecated. Use the Embedding API v3 instead for embedding interactive views into web pages and applications. The Embedding API v3 improves upon the previous library by offering features you expect for modern JavaScript development, including support for ES6 modules, web components, and availability as an NPM package. For guidance on embedding Tableau views, see the [Tableau Embedding API v3 Help](https://help.tableau.com/current/api/embedding_api/en-us/index.html). For information about switching from an older version of the Embedding API, see [Upgrade from Tableau JavaScript API v1 and v2](https://help.tableau.com/current/api/embedding_api/en-us/docs/embedding_api_migration_guide.html).

You can embed interactive Tableau views into web pages, blogs, wiki pages, web applications, and intranet portals. Embedded views update as the underlying data changes, or as their workbooks are updated on Tableau Server or Tableau Cloud.

Use the Tableau JavaScript API to integrate Tableau visualizations into your own web applications.

Here are some of the things that you can do with the JavaScript API:

- Display visualizations from Tableau Server, Tableau Public, and Tableau Cloud in web pages.
- Dynamically load and resize visualizations.
- Filter the data displayed in visualizations with HTML controls in the page.
- Select marks in visualizations.
- Respond to events in visualizations.
- Export visualizations to an image or PDF file.

For information on the latest features of the JavaScript API, see [What's New in the JavaScript API](https://help.tableau.com/current/api/js_api/en-us/JavaScriptAPI/js_api_whats_new.htm).

## Get Started

1. Create a web page and include the JavaScript API file from the Tableau Server that hosts your visualizations:
    
    ```
    <script src="https://YOUR-SERVER/javascripts/api/tableau-2.min.js"></script>
    ```
2. Create a `div` element in the page `body` where you want to insert the Tableau visualization:
    
    ```
    <div id="vizContainer"></div>
    ```
3. Write a function in a JavaScript file to display the visualization:
    
    ```
    function initViz() {
        var containerDiv = document.getElementById("vizContainer"),
        url = "https://YOUR-SERVER/views/YOUR-VISUALIZATION";
    
        var viz = new tableau.Viz(containerDiv, url);
    }
    ```
4. Call the function when the page is done loading:
    
    ```
    initViz();
    ```
    
    The result is below. To view the full code sample, see [Basic Embed](https://help.tableau.com/current/api/js_api/en-us/JavaScriptAPI/js_api_sample_basic_embed.htm).