2024.1 Migration Guide
This release introduces a major change to how PSPDFKit for Web is served from PSPDFKit Server, and it requires your attention.
This release doesn’t include any database migration.
Server Stops Shipping with the Web SDK Bundle
As of this version, Server will no longer be shipping with the Web SDK bundle.
In the past, you loaded the Web SDK by referencing its bootstrap script like so:
This will still work after the update, as Server now proxies these requests to an external Web SDK repository served under https://cdn.cloud.pspdfkit.com. However, there are limitations to this approach and it’s recommended to start serving the Web SDK yourself if:
You can’t or don’t want to provide access to the Web SDK repository, as Server won’t be able to proxy the files.
You wish to use a newer version of the Web SDK, since Server serves the latest version of the Web SDK at the time of the Server release, which might be older than the latest Web release.
How to Serve the Web SDK
There are multiple options for serving the Web SDK to your frontend, depending on your environment.
The simplest option is to add it to the static assets of your application. You can then refer to it the same as you refer to any other script:
The Web SDK infers the actual Server URL from the base URL of the
pspdfkit.js script tag. If you want to serve it from a different location than PSPDFKit Server, you’ll need to configure the
serverUrl of your Server instance in the Web SDK configuration:
Migrate PSPDFKit for Web
For information on PSPDFKit for Web migration, see PSPDFKit for Web 2024.1 Migration Guide.