Get Custom View Image
Retrieves an image for a custom view (a saved or personalized state of a published sheet, including the user's filters). For a published view without a custom view, use Get View Image with the view id.
APIs called
This tool talks to the Tableau REST API (Tableau Cloud or Server): it renders the custom view
image, and — when tool scoping is enabled —
resolves the custom view's underlying published view so the configured scope can be enforced before
the image is returned. The MCP-layer OAuth gate requires the union of the scopes cited per operation
below (tableau:views:download and tableau:content:read) plus tableau:mcp_site_settings:read to
read per-site MCP configuration overrides when MCP site settings are enabled.
- Render the custom view image. Returns the custom view rendered at high resolution in the
requested
format, applying anywidth,height, andviewFilters.GET /api/{version}/sites/{siteId}/customviews/{customViewId}/image— render the custom view image. Issued against the Tableau REST API; requires thetableau:views:downloadOAuth scope. Get Custom View Image
- Resolve the underlying view for tool scoping (only when
tool scoping is enabled). Looks up the custom
view's underlying published view and checks it against the configured project / workbook / view /
tag scope before rendering.
GET /api/{version}/sites/{siteId}/customviews/{customViewId}— resolve the underlying view id of the custom view. Issued against the Tableau REST API; requires thetableau:content:readOAuth scope. Get Custom ViewGET /api/{version}/sites/{siteId}/views/{viewId}— read the resolved view to enforce the configured scope. Issued against the Tableau REST API; requires thetableau:content:readOAuth scope. Get View
Required arguments
customViewId
The LUID of the custom view. This appears in the Tableau URL for a saved view (e.g. the
<customViewId> in /views/WorkbookUrl/SheetUrl/<customViewId>/<customViewName>), not the
published view id returned by List Views for the sheet alone.
Optional arguments
width
The width of the rendered image in pixels that, along with the value of height determine its
resolution and aspect ratio.
Example: 1600
height
The height of the rendered image in pixels that, along with the value of width, determine its
resolution and aspect ratio.
Example: 1200
format
The format of the image. Default: PNG
PNG(default): Raster image format. Works with all Tableau Server versions.SVG: Vector graphics format. Scalable and smaller file size. Requires Tableau Server 2026.2.0+ (REST API v3.29+).
Choosing a format:
- Prefer
PNGwhen the image will be analyzed or interpreted (e.g. answering questions about the data in the viz). - Prefer
SVGwhen the image will be displayed to the user (e.g. embedding or rendering the viz in a response).
Example: SVG
Requesting SVG when the connected Tableau Server is older than 2026.2.0 is refused: SVG format
requires Tableau Server 2026.2.0 or later. Current version: the message includes the connected
server's product version. If the image format feature is disabled on this Tableau Server, the tool
reports that the image format feature is disabled.
viewFilters
Map of filter field names to values; sent as vf_<fieldname> query parameters per
filter query views.
Example result
- When
formatisPNG, the MCP result will contain the PNG image content (MCP result withtype=imageandmimeType=image/png). - When
formatisSVG, the MCP result will contain both the SVG XML (type=text) and the SVG image content (type=imageandmimeType=image/svg+xml)

Related
get-view-image— image of a published view by view idget-custom-view-data— CSV data for a custom viewlist-custom-views— find custom view LUIDs
Response behavior
The tool returns one of two result shapes:
MCP_S3_BUCKETunset (default): returns the rendered image inline, base64-encoded.MCP_S3_BUCKETset: returns aresource_linkwith a short-lived presigned URL to the rendered image in S3 (withmimeTypematchingformat), instead of inlining the image data.
Example result (S3 mode)
{
"type": "resource_link",
"uri": "https://example-bucket.s3.amazonaws.com/...presigned...",
"name": "view-image.png",
"mimeType": "image/png",
"description": "Rendered view image stored in S3. This is a short-lived presigned URL."
}