Customize Tableau Mobile with AppConfig

If you use mobile device management (MDM) or mobile application management (MAM), you can customize Tableau Mobile with app configuration parameters.

Custom app configuration is controlled by key/value pairs, which MDM and MAM systems handle slightly differently. For specific steps, refer to help from your vendor below.

App configuration parameters for MDM systems

These key/values pairs apply to the standard Tableau Mobile app.

Note: Android Enterprise is required to use app configuration parameters on the Android platform.

Key Example Value Description
AppServiceHosts
(string)
https://tableau.example.com,

https://tableau.example-sales.com

Displays a list of servers for users to choose from during sign-in. Separate the servers with commas.
AppServiceHostLabels
(string)
Website Metrics,

Sales Analytics

Specifies the displayed names for AppServiceHosts entries. Separate the names with commas.
CustomHostsTitle
(string)
My Company's Tableau Servers Sets the title for the list of default servers that appear at sign-in. If you don't specify this value, "Custom Servers" is displayed.
DisableDataDownload
(boolean)
True In workbooks accessed on mobile devices, disables the View Data option for tooltips, as well as all options in the Download menu (Image, Data, Crosstab, and PDF).

Tip: To set download permissions that apply to mobile and desktop devices, use the standard Tableau administrative options.

HideServerNameField
(boolean)
True Prevents users from typing a server name during sign-in.

Tableau Mobile also supports the previous name of this key, "RestrictServers".

RemoveTableauOnlineButton
(boolean)
True Removes the Tableau Online button from the sign-in options.
RequireAppLock
(boolean)
True Enforces an app lock, which requires users to open the app using biometrics or a passcode.

Tip: For Server versions 2019.4 and later, you can also enforce app lock with a site setting. See Enable app lock for added security. If either the site setting is enabled or RequireAppLock is set to true, an app lock will be enforced.

App configuration parameters for MAM systems

These key/value pairs apply to the unique iOS apps, Tableau Mobile for Blackberry and Tableau Mobile for Workspace ONE.

Key Example Value Description
AppServiceHosts
(string)
https://tableau.example.com,

https://tableau.example-sales.com

Displays a list of servers for users to choose from during sign-in. Separate the servers with commas.

Users can type a server name that differs from these defaults, unless you use the RestrictServers key.

Note: Enter default hosts carefully; servers appear as options even if they're offline or the address is incorrect.

AppServiceHostLabels
(string)
Website Metrics,

Sales Analytics

Specifies the displayed names for AppServiceHosts entries. Separate the names with commas.
CustomHostsTitle
(string)
My Company's Tableau Servers Sets the title for the list of default servers that appear at sign-in. If you don't specify this value, "Custom Servers" is displayed.
DisableKerberosError
(boolean)
True If your organization uses Kerberos authentication only for desktop and laptop computers, set this key to True to prevent Kerberos error messages in Tableau Mobile.
DisableSavedCredentials
(boolean)
True Disables the "Remember me" sign-in option, preventing credentials from being stored on mobile devices.
HideServerNameField
(boolean)
True Prevents users from typing a server name during sign-in.

Tableau Mobile also supports the previous name of this key, "RestrictServers".

RemoveTableauOnlineButton
(boolean)
True Removes the Tableau Online button from the sign-in options.
RestrictUsername
(boolean)
True If a UserName value exists, you can prevent users from replacing it by setting this key to True.
UserName
(string)
NetworkUserName Automatically inserts the user name during sign-in, which users can replace. This doesn't apply if you use single sign-on via SAML or Kerberos.

Example structure for an XML property list

MobileIron, XenMobile, and Intune use XML property list (.plist) files to set AppConfig values. Below is an example XML structure that uses some of the key/value pairs supported by Tableau Mobile. You can copy this example and customize it for your organization.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>AppServiceHosts</key><string>tableau.example.com,tableau.example-sales.com</string>
	<key>AppServiceHostLabels</key><string>Website Metrics,Sales Analytics</string>
	<key>RemoveTableauOnlineButton</key><true/>
	<key>RestrictServers</key><false/>
</dict>
</plist>
Thanks for your feedback! There was an error submitting your feedback. Try again or send us a message.