Graphed LogoGraphed
Graphed LogoGraphed
How It WorksAgentsIntegrationsPricing

How to Deactivate Tableau License

Cody Schneider••8 min read

Moving your Tableau license to a new computer or freeing it up for a colleague should be a simple task. This guide provides clear, step-by-step instructions for deactivating your Tableau Desktop and Tableau Server licenses, so you can manage your software without any headaches. We'll cover both online and offline deactivation methods and offer tips for common issues you might encounter.

GraphedGraphed

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.

Watch Graphed demo video

Why Deactivate a Tableau License?

Before jumping into the "how," it's helpful to understand the "why." Deactivating a Tableau license is essentially telling Tableau that you're no longer using the product key on that specific machine. This frees up the activation credit, allowing the key to be used on another computer. You'll typically need to do this in a few common scenarios:

  • Upgrading or Replacing Your Computer: This is the most frequent reason. If you get a new laptop, you must deactivate the license on your old machine before you can activate it on the new one.
  • Moving to a Virtual Machine: If you're transitioning your work environment to a virtual desktop, you'll need to transfer the license from your physical computer.
  • Changing User Assignments: When an employee leaves the company or moves to a different role, you need to deactivate the license on their machine so it can be reassigned to someone else.
  • Re-imaging a Machine: If your IT department is going to wipe and re-image your computer's hard drive, deactivating the license first is a critical step to avoid losing the activation.

Forgetting to deactivate a license, especially on a computer that is about to be decommissioned, can lead to a frustrating support ticket. Taking a minute to do it properly saves you and your team a lot of time later.

Before You Begin: A Quick Checklist

A little preparation goes a long way. Before you start the deactivation process, take a moment to do the following:

  1. Save Your Workbooks: Ensure all your Tableau workbooks (.twb or .twbx files) are saved in a secure location, like a network drive or cloud storage. Deactivation won't delete your files, but it's always best practice, especially if you're decommissioning the machine.
  2. Find Your Product Key: While you don't always need the product key to deactivate, you will absolutely need it to activate on your new machine. You can find your key by opening Tableau Desktop and navigating to Help > Manage Product Keys. Copy it down and store it somewhere safe.
  3. Check Your Internet Connection: The standard, and easiest, deactivation method requires an internet connection. Make sure your computer is online. If it's not, don't worry - we'll cover the offline process next.

How to Deactivate Tableau Desktop

Deactivating Tableau Desktop is a straightforward process that you can handle yourself. The method you choose will depend on whether the computer is connected to the internet.

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.

Method 1: Online Deactivation (The Standard Way)

This is the quickest method and works for 99% of situations. It takes less than a minute. Here are the steps:

  1. Open Tableau Desktop on the computer where you want to deactivate the license.
  2. In the top menu, go to Help > Manage Product Keys...
  3. The "Manage Product Keys" dialog box will appear, showing the product key currently active on the machine.
  4. Select the product key you wish to remove from the list.
  5. Click the Deactivate button.
  6. Wait for a confirmation message from Tableau letting you know the deactivation was successful. Tableau will then close.

That's it! The license has been returned to Tableau's activation server and is now available to be used on another computer.

Method 2: Offline Deactivation

What if the computer can't connect to the internet due to security policies or hardware issues? You can still deactivate your license, but it involves a few extra steps. You'll need access to another computer with internet access and a way to transfer a small file between them (like a USB drive).

This process works by having you create a "deactivation request file" on the offline machine, process that file on an online machine via the Tableau website, and then bring a "return confirmation file" back to the offline machine to complete the process.

Part 1: On the OFFLINE Computer

  1. Attempt to deactivate using the online method first. Open Tableau Desktop, navigate to Help > Manage Product Keys, select your key, and click Deactivate.
  2. Because the computer is offline, the deactivation will fail. However, this failure is necessary to trigger the offline option. Tableau will display a message giving you the choice to save a file for offline deactivation.
  3. Click the button that says something like "Save for offline Deactivation" or "Create Activation File."
  4. This will prompt you to save a deactivation request file. The default name is usually return.tlq. Save this file to a location you can easily access, such as your desktop or a USB drive.
  5. Now, move the return.tlq file to a computer that does have internet access.

Part 2: On the ONLINE Computer

  1. On the computer with an internet connection, open a web browser and go to the Tableau Activation page.
  2. On the activation page, click the "Choose File" button and select the return.tlq file you transferred from the offline machine.
  3. Click the "Upload Activation File" button. The website will process your deactivation request and generate a new file for you to download called return.tlr (Tableau License Return).
  4. Download this return.tlr file and transfer it back to the offline computer.

Part 3: Finalizing on the OFFLINE Computer

  1. Back on the original (offline) machine, open Tableau Desktop again.
  2. When prompted, select the option to process the return file. You may need to navigate to Help > Manage Product Keys if Tableau opens fully.
  3. Upload the return.tlr file you just transferred. Tableau will process this file, and your license will now be officially deactivated. You should receive a confirmation message.

While it has a few more steps, the offline process is a reliable fallback when you can't get the machine online.

How to Deactivate Tableau Server

Deactivating a Tableau Server license is a task for system administrators and requires command-line access to the server. Unlike Desktop, there's no graphical interface for this process. Instead, you'll use the Tableau Services Manager (TSM) command-line interface.

Important: Deactivating your license will shut down all Tableau Server processes, so plan for downtime and perform this action during a maintenance window.

GraphedGraphed

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.

Watch Graphed demo video

Steps for Deactivating Tableau Server

  1. Open a Command Prompt as an Administrator (on Windows) or a terminal session (on Linux) on the initial node of your Tableau Server installation.
  2. Use the following TSM command to deactivate your Tableau Server product key:
tsm licenses deactivate -k <product_key>

Replace <product_key> with your actual Tableau Server product key. For example:

tsm licenses deactivate -k TS12-3456-7890-ABCD-EFGH
  1. If you have add-on licenses to deactivate (like Tableau Data Management), you'll need to run the command for each key separately.
  2. The command will run and provide a confirmation once the deactivation is complete. The server will be stopped during this process.

Just like with Tableau Desktop, this command can be run offline too. If the server cannot connect to the internet, you can generate an offline request file using the --offline flag and follow a similar two-part process to complete the deactivation on the Tableau website.

tsm licenses deactivate -k <product_key> --offline

Troubleshooting Common Deactivation Issues

Even with a clear process, things can occasionally go wrong. Here are a few common problems and how to solve them.

Problem: My Computer Crashed, and I Can't Open Tableau to Deactivate it.

This is a frustrating reality for many. If the computer is completely inaccessible (due to a hard drive failure, for example), you can't run the deactivation process yourself. In this case, you will need to contact Tableau Support directly. They can verify your license details and manually deactivate the key on their end so you can use it on a new machine.

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.

Problem: "No license found to be deactivated" Error.

This error sometimes appears if the license information on the computer has become corrupted or if you're trying to deactivate a key that isn't the one actively in use. The best approach is to open Help > Manage Product Keys, carefully note the key listed there, and try again. If it persists, a clean reinstall of Tableau might be necessary after noting your product key, but it's often faster to contact Tableau support.

Problem: I Don't Have My Product Key.

If you can't find your key within the Tableau Desktop application, you can usually find it in the Tableau Customer Portal. Log in with your corporate credentials and navigate to the "My Keys" section to see a list of all licenses assigned to you or your organization.

Final Thoughts

Deactivating a Tableau license is a manageable task once you know the steps. Whether you're moving a Desktop license to a new computer or decommissioning a Server, following the correct online or offline procedure ensures your license is always ready to be used where it's needed most.

Managing licenses and navigating complex software is just one part of the data analysis puzzle that costs teams time. We believe getting insights from your data shouldn't be so manual. That's why we created Graphed, which uses natural language to help you connect your data sources and build real-time dashboards in seconds. Instead of a steep learning curve or wrangling commands, you can simply ask questions and get the answers you need to grow your business, freeing your team to focus on strategy instead of administration.

Related Articles