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:
This tool allows you to:
Replace the old
.trex
reference with the new oneApply 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.
💡 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!
Last updated