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.

Parameters for MDM systems, BlackBerry MAM, and Intune MAM

These key/values pairs apply to the standard Tableau Mobile app and unique iOS apps, Tableau Mobile for BlackBerry and Tableau Mobile for Intune.

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.

RequireSignInWithDeviceBrowser
(boolean)
True Allows Tableau Mobile to use the device’s browser (Safari, Chrome) for authentication. Needed for OpenID Connect/Google and mutual SSL authentication methods. For more information, see Authentication with the device browser.

Overrides the user setting "Sign in with Device Browser".

Parameters for Workspace ONE MAM

These key/value pairs apply to the unique iOS app, Tableau Mobile for Workspace ONE. For other versions of Tableau Mobile, use the Parameters for MDM systems, BlackBerry MAM, and Intune MAM .

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, Citrix Endpoint Management, and Microsoft 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. Please try again.