Skip to content

CDN assets

rrweb browser assets are served from https://cdn.rrweb.com.

Use the CDN for browser-loaded scripts and styles.

URL shape

CDN asset URLs use this shape:

txt
https://cdn.rrweb.com/<package>/<version-or-channel>/<file>

Examples:

html
<script type="module">
  import { start } from 'https://cdn.rrweb.com/browser-client/next/browser-client.js';

  start({
    publicApiKey: 'your-public-api-key-here',
  });
</script>
<script
  type="module"
  src="https://cdn.rrweb.com/rrweb-player/next/rrweb-player.js"
></script>
<link
  rel="stylesheet"
  href="https://cdn.rrweb.com/rrweb-player/next/style.css"
/>

Versions and channels

Exact version URLs are immutable. Once https://cdn.rrweb.com/rrweb-player/2.0.0-alpha.20/rrweb-player.js is published, republishing different bytes to that object is rejected by the publish tooling.

current redirects to the latest stable rrweb version once stable releases exist in the catalog.

next redirects to the latest prerelease with next in the version when one exists. Otherwise it will point to the latest current release.

Catalog

The public catalog is available at:

txt
https://cdn.rrweb.com/catalog.json

The catalog lists available versions, packages, aliases, and canonical files. The CDN can also serve other published files for a package and version, which keeps older releases working when file names or layouts changed over time.

Publishing

Generated assets are not committed to Git. Published exact version URLs are immutable, while current and next move forward through redirects.