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.