# What changed in redocusaurus

> 12 changes in redocusaurus 1 to 2 from its official release notes, upgrade guides and advisories: 6 breaking, 2 new APIs and options. Each one cited. Sources checked 2026-10-31. HTML: https://unstale.sh/npm/redocusaurus/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## redocusaurus 2

### Fixes and other changes

- Fixes a ReferenceError when using @docusaurus/faster with additionalLanguages. (2.5.1) — [release notes](https://github.com/rohit-gohri/redocusaurus/releases/tag/v2.5.1)
- Fixes scroll-spy URL updates when loading a page directly. (2.5.1) — [release notes](https://github.com/rohit-gohri/redocusaurus/releases/tag/v2.5.1)

## redocusaurus 1

### Breaking changes

- Removed because `route` is optional; omit it when no route is needed. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- Removed; `useSpecData` can load plugin data for use with `@theme/Redoc`. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- Replaces `redocOptions`; some defaults were removed, leaving customization to the user. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- `downloadUrl` is no longer hidden by default. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- Removed; the package handles spec URLs based on the passed spec and bundles definitions into a downloadable YAML static asset at build time. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- The experimental component was removed; build-time and server-side rendering now work without it. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)

### New APIs and options

- Replaces `routePath` and is now optional, so a route does not need to be passed when one is not needed. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- A new hook loads YAML files so the result can be passed directly to `@theme/Redoc`. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)

### Behavior and default changes

- Build-time and server-side rendering now work for everyone by default without requiring extra setup. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)
- Can now be a local file path, an absolute URL, or a multi-file OpenAPI entrypoint that the package bundles. (1.0.0) — [upgrade guide](https://redocusaurus.vercel.app/docs/guides/migrating-to-v1)