# Tableau Extensions API versions and features

> Which Tableau Extensions API version adds which feature, and the minimum-api-version floor a viz or dashboard extension must declare.

Canonical: https://ext.tableauops.com/knowledge/extensions-api-versions
Updated: 2026-09-18
Author: Eric Summers

Every hosted Tableau extension declares a **minimum API version** in its manifest. Pick too low a floor and a method you call throws on the user's Tableau; pick too high and older Tableau builds refuse to add the extension at all.

## The two floors

- **Viz extensions** need at least API **1.12** (Tableau 2024.2). A worksheet's default manifest often reads 1.4 or 1.11, which fails to add a custom mark. This is the single most common "it will not add" cause.
- **Dashboard extensions** need at least API **1.10**.

Set `min-api-version` to the lowest version that has every feature you use, and no lower.

## Features by API version

Each row lists the capabilities that arrived in that API version. If you call one, your manifest floor must be at least that version.

| API version | Adds |
| --- | --- |
| `1.13` | `WorksheetFormattingChanged`, `worksheet.formatting`, `applyWorksheetFormatting` |
| `1.17` | `reportExtensionRenderComplete`, `environment.isExporting`, `ExportedMediaType` |

## FAQ

### What min-api-version does a viz extension need?
At least 1.12 (Tableau 2024.2). The worksheet default of 1.4 or 1.11 will not add a custom mark type.

### Why does my extension fail to add on an older Tableau?
Your manifest floor is higher than that Tableau's API. Either lower the floor (and stop using the newer method), or tell the user which Tableau version they need.


---
Try it live: Build one free in Studio — https://ext.tableauops.com/studio