How to Update Tableau Server License Key

So, your Tableau Server license renewal date is approaching, or maybe you've just purchased more capacity. Whatever the reason, it's time to update your product key. This might sound intimidating, but it's a routine task that Tableau has made fairly straightforward. This guide will walk you through everything you need to know, from pre-update checks to step-by-step instructions for both the command line and web interface methods.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

First, Why Do You Need to Update Your Tableau License?

Updating your license key isn't just about keeping your subscription active. It's a necessary step for several common scenarios:

• Renewing Your Subscription: When you renew your Tableau Server license, you receive a new product key. You need to activate this new key on your server to reflect the new expiration date.
• Adding Capacity: If your team is growing, you might purchase additional Creator, Explorer, or Viewer licenses. This change is reflected in a new or updated product key that you need to apply.
• Upgrading Features: When you add features like the Data Management or Advanced Management Add-ons, Tableau typically issues a new key that enables this new functionality.
• Switching License Models: Moving from a user-based to a core-based license (or vice-versa) also requires a key update.

In all these cases, the goal is the same: to make sure your Tableau Server environment is up-to-date and correctly licensed.

Before You Begin: A Quick Pre-Update Checklist

A little preparation can prevent common headaches. Before you touch anything, run through this quick checklist:

1. Find Your New Product Key: Your new product key is the most important piece of the puzzle. You can find it in the Tableau Customer Portal. It's usually a long string of letters and numbers, often starting with "TS". Copy it somewhere safe and accessible.
2. Verify Admin Access: You need administrative permissions on the machine where Tableau Server is installed to use Tableau Services Manager (TSM). Without it, you won't be able to run the necessary commands.
3. Check Server Status: Ensure your Tableau Server is running. While activating a new key usually doesn’t cause downtime, it's best to perform the update when the server is in a stable, running state. You can check the status with the TSM command: tsm status -v
4. Schedule a Maintenance Window (Optional): While activating or refreshing a key typically doesn't require a full server restart, applying certain pending changes in TSM might. It’s always best to perform administrative tasks like this during off-peak hours, just in case.

With these items checked off, you're ready to proceed. You have two primary methods for updating your license: the Tableau Services Manager (TSM) Command Line Interface or the TSM Web User Interface.

Method 1: Using the TSM Command Line (CLI)

The TSM command line is the preferred method for many administrators because it's fast, efficient, and can be automated with scripts. It gives you precise control over the licensing process.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Step 1: Open a Command Prompt as Administrator

On your Tableau Server, open the Command Prompt (or Terminal on Linux). Make sure you run it as an administrator. This is essential for TSM commands to execute correctly.

Step 2: Activate the New License Key

The primary command you'll use is tsm licenses activate. This command both activates your new key and, depending on your license type, may also refresh all existing keys on the server.

Type the following command, replacing <new_product_key> with the key you got from the Tableau Customer Portal:

tsm licenses activate -k <new_product_key>

Press Enter. TSM will attempt to contact Tableau's licensing servers to validate and activate the key.

Step 3: Verify the License Details

After a successful activation, you should verify that the new license is active and the details are correct. The best way to do this is with the tsm licenses list command:

tsm licenses list

This command outputs a table of all active license keys, their types (e.g., Creator, Server), the number of licenses, and their expiration dates. Check this list to confirm your new key is present and that the expiration date aligns with your renewed subscription.

Note on Deactivating: In most renewal scenarios, you don't need to manually deactivate the old key. The activation process often handles it. However, if you are completely changing license types, you may want to deactivate the old key first using tsm licenses deactivate -k <old_product_key>.

Graphed

Build AI Agents for Marketing

Build virtual employees that run your go to market. Connect your data sources, deploy autonomous agents, and grow your company.

Build Your First Agent

Step 4: Restart Tableau Server (If Needed)

Activating a new key generally does not require a full server restart. The changes typically apply immediately. However, if other configuration changes were pending, TSM may require you to apply them. If prompted, run:

tsm pending-changes apply

This command may initiate a server restart, so be prepared.

Method 2: Using the TSM Web User Interface (Web UI)

If you prefer a graphical interface, the TSM Web UI is an excellent alternative. It provides the same functionality as the command line in a user-friendly browser window.

Step 1: Log in to the TSM Web UI

Open a web browser and navigate to your TSM URL, which is typically:

https://<your-server-name>:8850

Log in with your administrator credentials for the server machine.

Step 2: Navigate to the Licensing Page

Once you're logged in, click on the Configuration tab in the top navigation bar. Then, from the options, select Licensing.

Step 3: Activate the New Product Key

On the licensing page, you will see a button labeled Activate License. Click this button.

A dialog box will appear. Here, you simply paste your new product key into the text field and click the Activate button below it.

TSM will connect to Tableau's servers and activate the key. Once a key is successfully activated, you might be prompted at the top of the screen to apply pending changes. Go ahead and click the "Apply Pending Changes" button if it appears.

AI Agents for Marketing

Crash Course

Graphed

Free PDF · the crash course

AI Agents for Marketing Crash Course

Learn how to deploy AI marketing agents across your go-to-market — the best tools, prompts, and workflows to turn your data into autonomous execution without writing code.

Download the PDF

Step 4: Verify the New License

After the activation is complete, the Licensing page will refresh. Your new product key should now be listed in the table, along with updated information about your license count or expiration date. This serves as your confirmation that the process was successful.

Troubleshooting Common Activation Issues

Sometimes, things don't go as planned. Here are solutions to a few common issues you might encounter.

• Error: Activation fails due to firewall/proxy. Tableau Server needs to reach Tableau's licensing servers on the internet. If your server is behind a strict firewall or proxy, the activation might fail. Ensure your server can access licensing.tableau.com on ports 80 and 443. If internet access isn't possible, you'll need to use the offline activation method, which involves generating a file from your server and completing the activation on a machine with internet access.
• Error: "Invalid Product Key" This is usually a simple copy-paste error. Double-check that you've copied the entire key without any extra spaces at the beginning or end. Also, confirm that the key is for the correct version of Tableau Server you are running.
• Problem: License details haven't updated in Tableau Server after successful activation. There can occasionally be a slight delay or caching issue. The TSM output is the definitive source of truth. If tsm licenses list shows the correct, new expiration date, you're good to go. The information inside the Tableau Server UI itself will catch up. A restart of the Tableau Server application (tsm restart) will force this update if you need it to reflect immediately.

Final Thoughts

Updating your Tableau Server license key is a vital administrative task that you can accomplish in minutes using either the TSM command line or the TSM Web UI. By following the preparation checklist and the step-by-step instructions, you can ensure your server remains fully licensed, active, and ready for your team.

For organizations managing complex tools like Tableau, administrative tasks like licensing are just one small part of the overhead. Often, the bigger challenge is the slow, manual process of building the reports your team needs. That’s why we built Graphed. We provide a simpler way, helping your entire team get dashboards and insights by just describing what they want to see. Instead of spending weeks learning a complicated new interface or hours wrestling with license keys, you can connect your data and start getting answers in plain English.