diff --git a/README.md b/README.md index a0ec36fb0..08ab9f5ad 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,8 @@ The package has different entry points for different environments. The browser e ``` +> ⚠️ **Warning**: Always include a specific version number (such as @6) when using CDN URLs like the `unpkg` example above. If you use a URL without a version, your application may automatically receive breaking changes when a new major version is released, which can lead to unexpected issues. + When evaluated, that bundle assigns the SDK's exports to `window.optimizelySdk`. If you wish to use the asset locally (for example, if unpkg is down), you can find it in your local copy of the package at dist/optimizely.browser.umd.min.js. We do not recommend using this method in production settings as it introduces a third-party performance dependency. As `window.optimizelySdk` should be a global variable at this point, you can continue to use it like so: