Troubleshoot Subscriptions

"The view snapshot in this email could not be properly rendered."

  If you receive a subscription with this error message, there could be several reasons:

  • Missing credentials: Some views are published with embedded credentials. You may receive the above error if the embedded credentials are now out-of-date, or if the view was republished without the embedded credentials.

  • Database temporarily down: If the view has a live database connection and the database was temporarily down when the subscription was being generated, you might receive the above error.

  • Background process timeout: By default, the background process that handles subscriptions has a timeout value of 30 minutes per view for the rendering of a view. If rendering a view goes beyond this time limit, the next view in the workbook results in a failed job due to the timeout. In the majority of cases, this default is plenty of time. However, if the background process is handling an extraordinarily large and complex dashboard, that may not be enough time. You can check the Background Tasks for Non Extracts admin view to see if that's the case. To increase the timeout threshold, use the tsm configuration set subscriptions.timeout command.

Can't see images in email

For images of content to display in a subscription email, users subscribed to views, in addition to View permissions, must also have Download Image/PDF permissions. For more information, see Permissions.

Can't see extensions or Pulse objects

In Tableau Cloud 2026.1 and later, you can download or subscribe to views that include extensions or Pulse dashboard objects. This functionality expanded in Tableau 2026.3 to include thumbnails for newly published workbooks, data alert emails, and REST API driven image exports.

Beginning in Tableau Server 2026.3.1, this expanded export functionality is available for Tableau Server deployments to support static output generation for views containing extension zones. This update enables static output generation that accurately reflects extensions, web zones, data apps, and image objects. Similar to Tableau Cloud, it supports user downloads, subscriptions, thumbnails, data-driven alerts, and REST API outputs.

Under certain conditions, newly generated outputs might still render these web-based objects as blank if compatibility requirements are not met.

If your web objects are blank, check these compatibility requirements:

Extension types:

  • Tableau Cloud: Only Tableau Trusted Extensions (available in the Tableau Exchange) and Pulse Dashboard Objects are supported. If the dashboard uses a Network-Enabled Extension, the object appears blank in the subscription image.

  • Tableau Server: Pulse Dashboard Objects aren't supported and appear blank. Network-Enabled Extensions, self-hosted or partner-hosted extensions, web page objects, and web image objects are supported if Tableau Server can reach them. An object appears blank if your network policies or firewall settings block access to its content. Contact your server administrator to confirm access.

Service availability (Tableau Server): Extensions and web content in subscriptions are rendered by the Web Content Snapshot Service. If an administrator has disabled the service, these objects appear blank, because the subscription falls back to legacy image export. Contact your server administrator to confirm the service is enabled.

Long-running views or extensions: When complex Tableau views or web-rendered content take longer to load, the Web Content Snapshot Service might capture the image before rendering completes. This can lead to snapshot images that display a loading spinner or incomplete zones. To prevent this issue, optimize the view using standard performance troubleshooting practices to reduce load time.

View state: Subscriptions are rendered based on the published version of the view or a saved Custom View. Unsaved changes or selections don't appear in the subscription email.

Export File Format: Extension and Pulse objects render only when subscriptions are delivered in image formats, and they are not currently supported in PDF attachments. Additionally, PNG is currently the only supported format for REST API exports that contain Extension zones; developers should refrain from specifying SVG format for these exports.

Workbook saving: Ensure the workbook is saved after adding a Viz Extension in Web Authoring so the subscription engine can access the new content. Similarly, if older published workbooks display blank thumbnails, republishing them manually refreshes their thumbnails in Tableau Cloud and Tableau Server.

Can't subscribe

If you can see a view on Tableau Server and it has a subscription icon (Subscribe icon.) in the upper right corner, you can subscribe to it.

To subscribe to a view, Tableau Server needs to be correctly configured (described in Manage Subscriptions(Link opens in a new window)) and the view you're subscribing to must either have embedded credentials for its data source or not rely on credentials at all. Examples of the latter include a workbook that connects to an extract that isn't being refreshed, or a workbook whose data is in a file that was included with the workbook at publish time. Embedding credentials is a step that happens in Tableau Desktop (see the Tableau Help(Link opens in a new window) for details).

No subscription icon

It's possible to see a view but be unable to subscribe to it. This can happen becausefor several reasons:

  • No subscriptions have been scheduled: If no subscriptions have been scheduled or all subscription schedules are disabled, the subscription icon won’t appear. To set a schedule for subscriptions, see Create or Modify a Schedule(Link opens in a new window).
  • The view uses a live database connection: Views with live database connections, where you’re prompted for your database credentials when you first click the view, aren't available for subscription. A subscription includes a view (or workbook), data, and a schedule. To deliver the data required for the view, Tableau Server either needs embedded database credentials or data that doesn't require credentials. Where live database connections are concerned, Tableau Server doesn't have the credentials, only the individual users do. This is why you can only subscribe to views that either don’t require credentials or have them embedded.
  • Tableau Server is configured for trusted authentication: You may also be able to see a view but be unable to subscribe to it (no subscription icon) if Tableau Server is configured for trusted authentication. See Ensure Access to Subscriptions(Link opens in a new window) for more information.
  • A live database connection uses OAuth authentication: A user may not be able to subscribe to the view if the OAuth credential isn’t embedded with the Live data source or saved with the user keychain, or if the OAuth refresh token has expired.

Receiving invalid or "broken" subscriptions

If you configured subscriptions on test or development instances of Tableau Server in addition to your in-production instance, disable subscriptions on your non-production instances. Keeping subscriptions enabled on all instances can result in your users receiving subscriptions that appear to be valid, but which don't work, or receiving subscriptions even though they've unsubscribed from the view or workbook.

Missing attachments

You can add a PDF attachment to your subscription if your administrator has it enabled. If the PDF attachment is missing from your subscription, it might be because the size of the PDF exceeds either the email server size limit or the maximum size limit set by server administrators. In Tableau Server, the maximum size limit for PDF attachments to subscriptions can be adjusted through the tsm configuration option subscriptions.max_attachment_size_megabytes. For more information, see Configure Server Event Notification and Set Up a Site for Subscriptions.

Starting in Tableau 2024.1, you can send emails with your own sending server, which allows you to send attachments with a maximum email size of 10MB.

To enable this feature, navigate to site settings, find the Customize Email Notifications section, and check the box next to Use your SMTP server.

Note: If you're using your own sending server, Tableau will attempt to send a subscription email with a subset of the attachment that is under the 10MB limit, but this isn’t guaranteed. If Tableau can't send the attachment, you'll see a message letting you know that the attachment is too large to send.

Suspended Subscriptions

By default, a subscription is suspended after 5 consecutive subscription failures. To change the threshold number of subscription failures that can occur before they’re suspended, use the tsm configuration set option, backgrounder.subscription_failure_threshold_for_run_prevention. This sets the threshold for the number of consecutive failed subscriptions necessary before suspending the subscription. This is a server-wide setting.

Only Server administrators can configure the threshold number of subscription failures before a subscription is suspended. For information on setting this threshold, see Set up a Server for Subscriptions.

By default, administrators aren’t emailed when a subscription is suspended, but can opt-in to suspension emails per site through My Account Settings.

Resume suspended subscriptions

Administrators and subscription owners can resume subscriptions in several ways:

  • from My Subscription tab in Content Settings

  • from the Subscriptions tab per workbook

  • from the Subscriptions tab under Tasks (Server Admins only)

When a subscription is resumed, the alert failing count goes back to zero. The next evaluation of the subscription will occur at the next scheduled evaluation time.

Can't set subscription frequency to "When Data Refreshes"

You can set subscriptions to run when an extract refreshes if the workbook uses a connection to a published extract. When creating or modifying a subscription, you might not see a Frequency option if the workbook uses:

  • More than one extract refresh
  • A live data connection

Subscriptions not arriving ("Error sending email. Can't send command to SMTP host.")

You may see the above error in Windows Event Viewer if subscriptions aren't arriving and your SMTP server is using encrypted (TLS) sessions. To send subscriptions to an SMTP server that is configured with TLS, you must configure secure SMTP on Tableau Server. See Configure SMTP Setup. (If you're experiencing this error, note that Tableau Server will still indicate that subscriptions are being sent in the Background Tasks for Non Extracts(Link opens in a new window) admin view.)

Missing data quality warnings or sensitivity labels

Data quality warnings and sensitivity labels are included in subscription emails when:

  • Tableau Server or Tableau Cloud is licensed with Data Management. For more information, see About Data Management.
  • Tableau Catalog is enabled. For more information, see Enable Tableau Catalog.
  • In site settings, the check box under High-Visibility Data Labels in View and Workbook Subscriptions is selected. (In earlier versions, the check box is under Data Quality Warnings in Subscriptions.)
Thanks for your feedback!Your feedback has been successfully submitted. Thank you!