# How to Replace or Update the TREX URL in a Tableau Workbook.

You don’t need to rebuild your Tableau dashboard to update or switch the extension connection (for example, when moving to a new server, updating a license, or switching from a trial to production setup).\
You can simply **replace the TREX URL reference** in your existing workbook.

***

#### ✅ Recommended Method: Use the Apps for Tableau Toolbox

Use the **Apps for Tableau Toolbox** to easily replace the extension in your workbook:

👉 [Go to the Toolbox](https://appsfortableau.infotopics.com/apps/toolbox/)

This tool allows you to:

* Replace the old `.trex` reference with the new one
* Apply updated license keys
* Avoid manual XML editing
* Keep your existing dashboard setup intact.

### 🧩 Alternative Method: Manually Replace the TREX URL

If you prefer not to use the Toolbox, you can manually replace the extension URL using a text editor (such as **Notepad++** or **VS Code**).

<figure><img src="/files/ZlfCKJ715XGUC1Sl3Qlj" alt=""><figcaption></figcaption></figure>

#### Steps:

* **Download and back up** your Tableau workbook.
* If it’s a .twbx, open it in Tableau and **save as a .twb** (unpackaged workbook).
* Open the `.twb` file in your text editor.

<p align="center"><img src="/files/p0pDBv5XCpoMqx9DF7NO" alt=""></p>

* **Search** for your current TREX or extension URL (e.g., `https://oldserver.com/extensions/WriteBackExtreme`).

<figure><img src="/files/3UxDOJjeVDSklf2pN8NL" alt=""><figcaption></figcaption></figure>

* **Replace** it with the new one (e.g., `https://newserver.com/extensions/WriteBackExtreme`).

<figure><img src="/files/kuwcBaaceH149MtOHjmH" alt=""><figcaption></figcaption></figure>

* Save and reopen the file in Tableau Desktop.
* Verify the extension loads correctly and points to the new environment.

<figure><img src="/files/mveV6s00CIqHsPF1JA8h" alt=""><figcaption></figcaption></figure>

* Republish your workbook to Tableau Server or Tableau Cloud.

Full details and image examples: [How to Replace the URL of the .trex blog](https://appsfortableau.infotopics.com/topic/tips-techniques/how-to-convert-from-trial-to-production-by-replacing-the-url-of-the-trex/)

⚠️ **Tip:** Always make a backup before editing workbook XML manually.

***

### Important: Extension whitelisting ⚠️

After updating the URL:

* The new domain must be **safelisted / whitelisted**
* Required for Tableau Server and Tableau Cloud
* Must be done by a Tableau Administrator

### 💡 When to Use This

You can use these methods for several scenarios:

* Migrating to a **new server or domain**.
* Moving from **trial to production**.
* Updating to a **new version** of the extension.
* Switching to a **different environment** (e.g., dev → test → prod).
* Replacing a **license-linked TREX** file.

***

**Need help?**\
Reach out to our team at <support@appsfortableau.com>, and we’ll assist you!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infotopics.com/general-faqs/general-faqs/how-to-replace-or-update-the-trex-url-in-a-tableau-workbook..md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.