Update Plugin Loader URL
INFO
Estimated upgrade time is 5 minutes.
TL;DR Topol Plugin Loader URL has changed. Update to the new URL. When using custom endpoints update CORS.What is the Plugin Loader URL?
The Plugin Loader URL is the endpoint used to load the Topol Plugin's core JavaScript file into your application. It serves the main script responsible for initializing and running the Plugin.
Topol is installed via NPM package
NPM Release of the Topol Plugin
We've released a new minior version 0.3.0 of the Topol Plugin. Please keep in mind that since Topol integration packages are still in 0.x.x we introduce breaking changes in minor versions.
The only breaking change in this release is an update to the Plugin Loader URL.
What Changed
<!-- PREVIOUS URL -->
<script
src="ttps://d5aoblv5p04cg.cloudfront.net/loader/build.js"
type="text/javascript"
></script>
<!-- NEW URL -->
<script
src="https://v3.email-assets.topol.io/loader/build.js"
type="text/javascript"
></script>Why This Is a breaking change
If you're using custom API endpoints or have previously enabled CORS for the old domain, you'll need to update your configuration to allow requests from the new URL. Requests originating from inside the Topol editor now come from https://v3.email-assets.topol.io.
What You Need to Do
Update to the latest version of the Topol Plugin 0.3.0.
If you rely on custom API endpoints and you have manually configured CORS for the old URL: https://d5aoblv5p04cg.cloudfront.net you need to update it to the new one: https://v3.email-assets.topol.io.
Topol is installed manually
Please note that if you use NPM integration packages to install Topol this is not necessary and you just need to update to major version.
If you have followed our Getting Started guide and used the provided JavaScript code (meaning the Plugin Loader URL is explicitly referenced in your HTML or JavaScript file), you’ll need to update it manually.
Follow these two steps:
- Locate the existing (deprecated) loader script in your HTML or JavaScript file:
<!-- PREVIOUS URL -->
<script
src="ttps://d5aoblv5p04cg.cloudfront.net/editor-3/loader/build.js"
type="text/javascript"
></script>
<!-- NEW URL -->
<script
src="https://v3.email-assets.topol.io/loader/build.js"
type="text/javascript"
></script>If you rely on custom API endpoints and you have manually configured CORS for the old URL: https://d5aoblv5p04cg.cloudfront.net you need to update it to the new one: https://v3.email-assets.topol.io.
Why is this update necessary?
Following our separation from the parent company, we have launched a new, independent Loader Domain to improve stability and take full ownership of the Topol Plugin infrastructure.
This change guarantees that no external service or entity can influence the Plugin’s development or functionality, giving our team complete freedom and control over the codebase going forward.
IMPORTANT: What happens if you do not update it?
Starting now, all new features, improvements, and bug fixes will only be available through the new Loader URL. If your Plugin still loads from the old (deprecated) domain, it will no longer receive updates or enhancements.
You may continue using the deprecated domain until June 30, 2026, but please note that it will not get any new features, improvements, or bug fixes during this period.
DANGER
After July 1, 2027, the old (deprecated) Loader Domain will be permanently shut down. From that date onward, the Topol Plugin will stop loading entirely unless you have manually updated to the new domain.
If you have any questions or need assistance, please don’t hesitate to contact our support.