Was this page helpful?
Yes No

Change Installation Settings after Installation

When you install Tableau Desktop and Tableau Prep Builder, there are several features that are turned on by default. For example, with Tableau Desktop, automatic product updates or the ability to automatically save user workbooks is included as part of the install. But you might have some features that you don't want users to have access to, such as the ability to upload crash dump files and logs. As an administrator you can turn some of these features off.

For Windows, you can turn some features off during installation. For a list of these features, see Installer properties in the Install Tableau Desktop and Tableau Prep Builder from the Command Line article. For Mac, you can turn some features off only after installation. If you need to change these settings after installation (both Windows and Mac), you can do so by changing the registry or .plist file.

To deploy the changes to remote computers, you can export the settings from the registry (Windows) or .plist (Mac) file, modify the settings you want to turn off and then use the modified file to create an automated script to push the updates to each computer where Tableau Desktop is installed.

Important: Always make a back up of the registry file before making any changes to it. Editing the Windows registry incorrectly can have harmful effects on your computer.

Turn off product updates (Tableau Desktop only)

The Product Updates feature lets users receive product updates automatically or check for and install maintenance updates as they become available. To turn off Product Updates after Tableau Desktop is installed, you must update the AutoUpdateAllowed key in the registry (Windows) or in the .plist file (Mac) for each computer where Tableau is installed.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the registry editor (regedit.exe).

  3. Set the AutoUpdateAllowed registry key to 0. The following table lists the location of the key for different products.

Product Location (64-bit Tableau and Windows)

Tableau Desktop

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau <version>\AutoUpdate

Tableau Public

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau Public <version>\AutoUpdate

Tableau Reader

HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau Reader <version>\AutoUpdate

To enable product updates again, follow the same procedure but set the registry key to 1 instead of 0.

Mac

Run one of the following commands from the Terminal command prompt.

Product Command
Tableau Desktop defaults write com.tableau.Tableau-<version> AutoUpdate.AutoUpdateAllowed "0"

For example, in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1 AutoUpdate.AutoUpdateAllowed "0"

Tableau Public defaults write com.tableau.Tableau-Public-<version> AutoUpdate.AutoUpdateAllowed "0"
Tableau Reader defaults write com.tableau.Tableau-Reader-<version> AutoUpdate.AutoUpdateAllowed "0"

To enable product updates again, run the same command but specify 1 instead of 0.

Turn off Autosave (Tableau Desktop only)

The Autosave feature enables Tableau Desktop to save your user's workbooks every few minutes so that they don't lose work in the event that the application stops unexpectedly. When the user reopens Tableau, a dialog box is shown with a list of the recovered files to select from. The user can open one or more recovered files and continue where they left off, or they can delete any files they don't want. If they delete the files, then any changes they made since the last time they saved are discarded. If they delete all files in the list, the recovery dialog box no longer shows until new recovered files are generated.

The Autosave feature is enabled by default. If you want to disable this feature during installation, you can change the setting for the AUTOSAVE property. In that case, the Enable Autosave menu option will not be available to the user. If you want to re-enable the Autosave feature after install, you can deploy a registry (or .plist for Mac) update to change the AUTOSAVE property setting for each computer where Tableau is installed. For more information about how to control this setting during install from the command line, see Installer properties

To turn off Autosave after Tableau Desktop is installed, you must update the AutosaveAllowed key in the registry (Windows) or in the .plist file (Mac) for each computer where Tableau is installed.

Windows

  1. As an administrator on the computer where Tableau Desktop is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe).

  3. Set the AutosaveAllowed registry key to 0.

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau <version>\Autosave

To enable Autosave again, follow the same procedure but set the registry key to 1 instead of 0.

Mac

Run the following command from the Terminal command prompt.

defaults write com.tableau.Tableau-<version> Autosave.AutosaveAllowed "0"

For example, in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1 Autosave.AutosaveAllowed "0"

To enable Autosave again, run the same command but specify 1 instead of 0.

Turn off usage reporting

To help us improve Tableau, you can share usage pattern data with us. We never collect any specific user data, only anonymous usage data. For example data source connection types (such as .csv, sql or Amazon Redshift), large data sets versus small data sets. For Tableau Prep Builder, this could also include number of steps in a flow (Tableau Prep Builder) or types of operations used (but no data specifics such as step names or formulas used), and so on.

Your data is confidential and we will never share this information with anyone.

If you don't want to participate in this option, you can opt out by clearing the usage reporting check box during installation or from the command line (Windows) by adding a command line that includes the property SENDTELEMETRY="0".

For information about disabling this option in the user interface see Install Tableau Desktop or Tableau Prep Builder from the User Interface. For information about disabling this option from the command line, see Installer options.

To opt out of this option after installation do one of the following:

From the product

  1. Open Tableau Desktop.

  2. From the top menu, select Help >Settings and Performance.

  3. Click on Share Usage Data to Improve Tableau to clear the check mark.

From the registry

To turn off usage reporting at the system level, follow the instructions for your operating system.

Windows

Open a command prompt and run the following command:

REG ADD "HKLM\Software\Tableau\<Tableau Version>\Telemetry" /v TelemetryEnabled /t REG_DWORD /d 0

Alternatively, follow these steps:

  1. As an administrator on the computer where Tableau Desktop is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe).

  3. Set the TelemetryEnabled registry key to 0.

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau <version>\Telemetry

To enable usage reporting again, follow the same procedure but set the registry key to 1 instead of 0.

Mac

Run the following command from the Terminal command prompt.

defaults write com.tableau.Tableau-<version> Telemetry.TelemetryEnabled "0"

For example, in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1 Telemetry.TelemetryEnabled "0"

To enable usage reporting again, run the same command but specify 1 instead of 0.

To opt out of this option after installation do one of the following:

From the product

  1. Open Tableau Prep Builder as an administrator.

  2. From the top menu, select Help >Settings and Performance.

  3. Click on Share Usage Data To Improve Tableau Prep Builder to clear the check mark.

From the properties file

Windows

  1. Navigate to the app folder in the directory where Tableau Prep Builder is installed. For example C:\Program Files\Tableau\Tableau Prep Builder <version>\resources\app

  2. Open the telemetryConfig.properties file in a text editor.

  3. Change maestro.telemetry.enabled=true to maestro.telemetry.enabled=false

  4. Save your changes and close the file.

Mac

For Mac, this setting is user-specific. This setting doesn't apply to any other users on the system unless they reinstall the application.

  1. Navigate to ~/Library/Application Support/Tableau Prep Builder/

  2. Open the telemetryConfig.properties file in a text editor.

  3. Change maestro.telemetry.enabled=true to maestro.telemetry.enabled=false

  4. Save your changes and close the file.

Turn off error reporting

If Tableau Desktop or Tableau Prep Builder has a problem and shuts down unexpectedly, crash dump files and logs are generated and placed in the Logs folder in your My Tableau or My Tableau Prep Builder repository. This option is enabled by default.

The data in these files can include machine-specific information, a snapshot of the contents of the memory at the time of the crash (this can include application activity details, data connection information, actions taken by the user or data being worked on in Tableau), and customer-identifiable information.

If your organization is subject to data privacy regulations, you can disable this option. You will need to complete different steps to disable this option for Tableau Desktop versus Tableau Prep Builder. Click on the tabs below to view the instructions for your application.

For Tableau Desktop, the next time the user opens the application, a dialog prompt opens that enables the user to take one of the following actions:

  • Upload the crash files.

  • Decline to upload the crash files.

  • Permanently opt out from uploading the crash files.

If the user uploads the files, they are zipped together into an encrypted package using a 2048-bit RSA key and sent to Tableau so that an engineer can analyze and identify the issues that caused the crash.

The encrypted package includes:

  • Crash dump files (.dmp)

  • Error log files related to the crash (.log)

  • Manifest files related to the crash (.maifest)

If your organization is subject to data privacy regulations, you can disable this prompt from showing by editing the registry (Windows) or running a script (Mac) on each desktop to prevent users from uploading the crash dump files and logs.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe)

  3. Set the CrashReportUpload registry key to 2.

    Registry key location: HKEY_CURRENT_USER\Software\Tableau\<version>\Prompts

Mac

Run the following command from the Terminal command prompt:

defaults write com.tableau-<TABLEAU VERSION>.plist Prompts.CrashReportUpload -string 2

For example in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1.plist Prompts.CrashReportUpload -string 2

For Tableau Prep Builder on Windows, you can turn off the error reporting option during install by either clearing the Enable error reporting check box on the Customize dialog or from the command line by including the property CRASHDUMP="0".

To turn this option off after install add the line maestro.enable_fault_reporting=false to the application properties section of the application.properties file.

This file is located in C:\Program Files\Tableau\<Tableau Prep Builder version>\resources\app .

Turn off dashboard extensions (Tableau Desktop only)

Use dashboard extensions to expand dashboard functionality with the help of web applications created by third-party developers. If you don't want to make this option available to your users you can disable this functionality during install by setting the DISABLEEXTENSIONS property to "1" or after install by editing the registry (Windows) or running a script (Mac) on each desktop.

For more information about disabling this option during install see Installer Properties in Installer options. For more information about dashboard extensions, see Use Dashboard Extensions.

Windows

  1. As an administrator on the computer where Tableau is installed, make a backup of the registry file before you make any changes to it.

  2. Open the Registry Editor (regedit.exe)

  3. Set the DisableExtensions registry key to 1.

    Registry key location: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau <version>\Settings\Extensions\DisableExtensions

Mac

Run the following command from the Terminal command prompt:

defaults write com.tableau-<TABLEAU VERSION>.plist Settings.Extensions.DisableExtensions "1"

For example in Tableau Desktop 2019.1, use this command:

defaults write com.tableau.Tableau-2019.1.plist Settings.Extensions.DisableExtensions "1"