Tableau Imager Troubleshooting: Fix Blurry Dashboard Exports
Exporting your Tableau dashboards to images or PDFs should result in crisp, professional visuals. However, automated exports via the Tableau Imager tool often look blurry, pixelated, or poorly formatted. This issue usually happens because the automated tool uses a default rendering resolution that does not match your dashboard layout.
Here is how to fix blurry exports and ensure high-resolution outputs every time. 1. Adjust the Device Preview Settings
Tableau often defaults to a mobile or low-resolution layout during automated command-line exports. Forcing a specific desktop layout fixes this issue. Open your workbook in Tableau Desktop. Click Device Preview at the top of the Dashboard pane. Select Desktop as your device type.
Click Add Desktop Layout to lock in these resolution settings. 2. Override the Pixel Density via Command Line
If you use Tabcmd or the Tableau REST API to trigger the imager, the default export resolution is 96 DPI. You can force Tableau to render at a higher pixel density by adding specific suffix parameters to your export URL. Locate your automated export script.
Append :render=true and :size=1920,1080 (or your exact dashboard dimensions) to the view URL. 3. Switch to Fixed Dashboard Sizing
Automatic sizing scales your dashboard dynamically based on the screen rendering it. During an automated imager task, the headless browser might scale down to a small default window, causing pixelation. Go to the Size options on the Dashboard pane. Change the dropdown from Automatic to Fixed size.
Select a standard high-resolution preset, such as Desktop Browser (1920×1080) or Laptop (1366×768). 4. Increase Server-Side Render Thresholds
If you manage Tableau Server, the server might be rendering the image using complex client-side graphics rules that degrade quality during automated tasks. You can adjust the threshold using TSM (Tableau Services Manager) commands. Open your command-line interface on the server.
Run: tsm configuration set -k vizqlserver.browser.render_threshold -v 100
Run: tsm pending-changes apply to restart services and apply the high-quality rendering threshold. 5. Leverage Vector Formats
If your destination supports it, stop exporting to raster image formats like PNG or JPEG. Exporting to PDF keeps text and lines in a vector format, preventing blurriness at any zoom level. Change your export command extension from .png to .pdf.
If you absolutely need an image, convert the resulting high-quality PDF into a PNG using a third-party command-line tool like ImageMagick with the density set to 300.
To help tailor these fixes to your specific setup, please let me know:
Are you running this automated export via Tabcmd, REST API, or Tableau Prep?
What version of Tableau Server or Cloud are you currently using?
Leave a Reply