Default Browser Used instead of Embedded Browser For Sign-in to Tableau Server from Tableau Desktop

Published: 14 Jan 2022
Last Modified Date: 03 Feb 2023


Starting with Tableau Desktop 2021.4, the default browser on the machine (external browser to Desktop) is launched for the sign-in to Tableau Server instead of using the embedded browser inside Tableau Desktop.  How to enable an embedded browser to function the same as older versions?


  • Tableau Desktop 2021.4 and later
  • Tableau Server 2021.4 and later


There are 3 possible solutions to change the new default behavior.

Option 1

Use the following Tableau Server TSM command. This setting applies to all server users across all sites.

tsm configuration set -k wgserver.authentication.desktop_externalbrowser -v false
tsm pending-changes apply

Option 2

Run Tableau Desktop with the DOverride=ExternalBrowserOAuth:off future flag.
  • Windows:
"C:\Program Files\Tableau\Tableau <Version number>\bin\tableau.exe" -DOverride=ExternalBrowserOAuth:off
  • Mac:
open -a "/Applications/Tableau Desktop" --args -DOverride=ExternalBrowserOAuth:off

Option 3

Specify WorkgroupUseEmbeddedBrowserServerSignIn value in Windows Registry or Mac plist.
  • Windows:
  1. Open the registry editor.
  2. Go to Computer\HKEY_CURRENT_USER\Software\Tableau\{version}\Settings.
  3. Add new DWORD value:
  • Name: WorkgroupUseEmbeddedBrowserServerSignIn
  • Value: 1
  • Mac: execute the command
defaults write /Library/Preferences/com.tableau.Tableau-<version>.plist Settings.WorkgroupUseEmbeddedBrowserServerSignIn -integer 1

Did this article resolve the issue?