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

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).

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.

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

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

• Save and reopen the file in Tableau Desktop.

• Verify the extension loads correctly and points to the new environment.

• Republish your workbook to Tableau Server or Tableau Cloud.

Full details and image examples: How to Replace the URL of the .trex blog

⚠️ 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 [email protected], and we’ll assist you!