Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Package and publish a working Viz or Dashboard Extension as a Table
tags: [Getting started]
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

Start with a working Viz or Dashboard Extension. To create one, follow [Get Started with Viz Extensions](../vizext/trex_viz_getstarted.md) or [Get Started with Dashboard Extensions](../dashext/trex_getstarted.md).

Expand Down
2 changes: 1 addition & 1 deletion website/docs/dataapps/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# (Cloud-only Beta) Data Apps

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._
Build custom analytical applications on governed Tableau data and share them through Tableau. A data app combines a custom web interface with Tableau data access and hosting. Its front-end resources are embedded in a packaged workbook and served by Tableau.

Start with the overview to understand the concepts, then follow the getting started and creation guides.
Expand Down
2 changes: 1 addition & 1 deletion website/docs/dataapps/trex_dataapp_admin_security.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Find administration and security guidance for Tableau data apps.
sidebar_label: Administration and Security
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

Administration and security guidance is available on two pages:

Expand Down
2 changes: 1 addition & 1 deletion website/docs/dataapps/trex_dataapp_details.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Data App Details
description: The workbook, manifests, web resources, data connections, and runtime access that make up a Tableau data app.
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

A data app is a Dashboard or Viz Extension whose web resources are packaged with a Tableau workbook. The workbook places the interface and connects its data sources; the package supplies its manifests and front-end code. Tableau serves the bundled resources when a viewer opens the published workbook. Application code runs in the viewer's browser and queries Tableau at runtime.

Expand Down
4 changes: 3 additions & 1 deletion website/docs/dataapps/trex_dataapp_examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Data App Samples
description: Explore application ideas and extension samples to learn patterns for Tableau data apps.
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

Start with a small application and inspect how it loads resources, initializes the Extensions API, and gets data. Then add the interactions needed for your users' workflow.

Expand All @@ -21,6 +21,8 @@ These scenarios illustrate design patterns; they are not downloadable data app s

## Learn from Dashboard and Viz Extension samples



The existing Extensions API samples demonstrate useful patterns for data access, filtering, parameters, and event handling:

- [Dashboard Extension Samples](../dashext/trex_examples.md) show applications that interact with dashboard content.
Expand Down
6 changes: 3 additions & 3 deletions website/docs/dataapps/trex_dataapp_getstarted.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ tags: [Getting started]

_The data apps beta is available only on Tableau Cloud._

Create a data app by describing what you want to an AI coding assistant. You provide details like the audience, questions, data source, interactions, and visual style. The assistant uses Tableau MCP and the Tableau plugin to connect your data, write the application, and package and publish it to Tableau Cloud. You review the app in Tableau and refine it through conversation.
You can create a data app by describing what you want to an AI coding assistant. You provide details like the audience, questions, data source, interactions, and visual style. The assistant uses [Tableau MCP](https://tableau.github.io/tableau-mcp/docs/getting-started) and the [Tableau plugin](https://github.com/tableau/tableau-plugin) to connect your data, write the application, and package and publish it to Tableau Cloud. You review the app in Tableau and refine it through conversation.

A data app combines a custom web interface with Tableau data access and hosting. For more about how it works, see [What are Tableau data apps?](./trex_dataapp_overview.md).

Expand All @@ -17,11 +17,11 @@ You need:
- Access to a Tableau Cloud site that supports the data apps beta.
- A **Creator** or **Explorer (can publish)** site role and permission to publish to your intended destination.
- A published Tableau data source that you can access. Have its name or link ready.
- An AI client that supports MCP connections, the Tableau plugin, and code execution. The assistant needs to work with local files and run the plugin's scripts.
- An AI client that supports [Tableau MCP](https://tableau.github.io/tableau-mcp/docs/getting-started) connections, the [Tableau plugin](https://github.com/tableau/tableau-plugin), and code execution. The assistant needs to work with local files and run the plugin's scripts.

:::note

Your data app will often make Tableau service API calls to read and modify data and metadata. Your site administrator needs to enable access to each endpoint called for the data app. You may need to prompt your AI coding assistant to list the methods and paths used by the data app and make a request to your administrator.
If you're using Tableau's hosted MCP server, make sure your agent has network egress access to the blob storage that Tableau MCP uses to temporarily store workbook files. For more information, see [Hosted Tableau MCP](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp).

:::

Expand Down
2 changes: 1 addition & 1 deletion website/docs/dataapps/trex_dataapp_manage.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Manage Data Apps
description: Configure data apps for a Tableau Cloud site and manage individual packages in site Settings.
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

As a site administrator, you manage data apps through the **Packages** tab on the site's **Settings** page. Data app enablement is configured **per site**. Review and configure these controls for each site where you want users to run data apps.

Expand Down
9 changes: 4 additions & 5 deletions website/docs/dataapps/trex_dataapp_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@ title: What are Tableau Data Apps?
description: Learn how Data Apps combine custom web applications with Tableau hosting and governed data.
---

The data Apps beta is available only on Tableau Cloud.
_The data Apps beta is available only on Tableau Cloud._

A **data app** is a purpose-built interactive application built with code to help users explore data, make a decision, or complete a workflow. A data App gives your custom viz or dashboard extension runtime access to governed Tableau data sources through Extensions API and Tableau REST API methods.
A **data app** is a purpose-built, interactive application built with code to help users explore data, make a decision, or complete a workflow. A data App gives your custom viz or dashboard extension runtime access to governed Tableau data sources through Extensions API and Tableau REST API methods.

Data apps also host your extension's web resources on Tableau service. You build the interface using the Tableau Extensions API and bundle its HTML, JavaScript, CSS, and images inside a packaged workbook (`.twbx`). These resources are embedded in the workbook and published with it. Tableau hosts and serves them when users open the published content, so you do not need a separate web server for the app's front end.
Data apps also host your extension's web resources on Tableau. You build the interface using the Tableau Extensions API and bundle its HTML, JavaScript, CSS, and images inside a packaged workbook (`.twbx`). These resources are embedded in the workbook and published with it. Tableau hosts and serves them when users open the published content, so you do not need a separate web server for the app's front end.

Your data app appears as a workbook in the Tableau Interface. A workbook can contain more than one data app.

Expand All @@ -26,7 +26,7 @@ A data app includes:
- The Tableau Extensions API JavaScript library, which connects the application to Tableau.
- A package that contains the extension and its resources, bundled with the workbook.

A Tableau Package (`.tpkg`) is a container for application resources and metadata. The package supplies the resources; the data dpp combines them with Tableau data to provide the user experience.
A Tableau Package (`.tpkg`) is a container for application resources and metadata. The package supplies the resources; the data app combines them with Tableau data to provide the user experience.

## What can you do with a Data App?

Expand Down Expand Up @@ -60,7 +60,6 @@ To create a data app, you need:
- At least Creator or Explorer (can publish) role for the site containing the data app
- Publish and Overwrite (to republish) access to the project for the data app
- View, Connect and API access to each published data source the data app uses
- Administrator site configuration allowing any Tableau REST API paths/methods the data app calls

## How do Data Apps differ from Dashboard and Viz Extensions?

Expand Down
2 changes: 1 addition & 1 deletion website/docs/dataapps/trex_dataapp_security.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Data App security
description: Understand data app data permissions, hosted resources, external origins, and Tableau API access.
---

The data apps beta is available only on Tableau Cloud.
_The data apps beta is available only on Tableau Cloud._

Data apps execute custom code in the viewer's browser and query Tableau data at runtime. Review both the code and the access it requires before publishing. Tableau hosting and data permissions provide controls for the app, but app owners still need to review dependencies and how data is used.

Expand Down
Loading