NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #570 most downloaded on Packagist
Swagger UI is a collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
Latest stable
v5.34.1
Last release 16 days ago
30 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
400 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
docker: Instruct browser not to cache swagger-initializer.js
Per OpenAPI 3.0 spec here,
Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27.
If a 2-line rendering is desired, hard-line breaks should be used, e.g. 2 white spaces, or a "" char, at the end of the line.
This release version, v4.10.3, is intended to immediately follow v4.10.0. The intermediate versions were failed releases.
Nothing published for this version
docker: Instruct browser not to cache swagger-initializer.js
Per OpenAPI 3.0 spec here,
Throughout the specification description fields are noted as supporting CommonMark markdown formatting. Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by CommonMark 0.27.
If a 2-line rendering is desired, hard-line breaks should be used, e.g. 2 white spaces, or a "" char, at the end of the line.
request-snippets: prevent scrolling errors from missing function
auth: use aria-label instead of name field
swagger-ui-react: export presets and plugins as static props (#7927) (3296e2e), closes #7923
build: correct export of ./dist/swagger-ui.css
build: webpack@5 and webpack-dev-server@4
SwaggerUI is now built using webpack@5, with dev support for webpack-dev-server@4
swagger-ui-es-bundle-core, which does not include dependenciesfile-loader, raw-loader, and url-loader.woff | .woff2 | .ttf | .eot fonts and htmlwebpack@5, and must be loaded separately and/or use resolve.fallback. As an example, SwaggerUI loads process, buffer, and stream-browserify as devDependencies in order to build development and production bundles.SwaggerUI-React:
swagger-ui-es-bundle-core, and similarly outputs swagger-ui-es-bundle-core to its dist directoryDev:
build-stylesheets needs to get built first,
then cleanup of any empty artifacts, before building the various production bundlesDev-helpers now relies on HTMLWebpackPlugin to inject css and bundle filesswagger-ui-react: load spec on initial render (#7856) (a81341d), closes #7578
build: do not pull whole highlight.js and refractor libs (#7852) (c73d718), closes #7851
requestSnippets: handle type: string, format: binary or base64 file upload data
auth: compensate for uninitialized config (6c10e4a), closes #7814
plugins: make swagger-js wrapActions overridable (#7753) (8ea3cfd), closes #7730
swagger-ui-react: fix prop type for defaultModelRendering (6b10708), closes #7783
This release comes with a release article that contains more information about the new unified SwaggerUI error handling mechanism
This is a patch release that supersedes v4.2.0 to properly build the downstream swagger-ui-react package. No other /src changes in this version.
swagger-ui-react: add source maps to npm distribution
security: disable reading config params from URL search params (#7697) (01a3e55), closes #4872, security advisory https://github.com/swagger-api/swagg
Note: to re-enable the functionality of reading config params from URL, set new
queryConfigEnabledcore parameter totrue. More info in documentation.
request JumpToPath component always as container
introduce Error Boundaries to handle unexpected failures (#7671) (b299be7), closes #7647
add source map of css file to swagger-ui-react
servers: prevent UI crash when changing Server with variables (fb7e98a), closes #7525
allow using functional components with hooks
More information in: https://github.com/swagger-api/swagger-ui/issues/7341 Release article: https://swagger.io/blog/news/what-s-new-in-swaggerui-v4-and-swaggereditor-v4/
highlight-code: handle mousewheel events properly (da4f70b), closes #7497
fix issue with highlight code scrolling causing console error
<wbr> (#7516) (f88334a), closes #7513a11n: provide proper a11n for response example tabs (#7464) (8ffb1ae), closes #7463 #7350
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
Dockerfile: fix security issue in docker image (cd0f56c), closes #7445
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
build-security: do not expose hostname to build framents (#7491) (fdef4ea), closes #7446
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
servers: compensate when server list contains a null value (414db4d), closes #7341
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
docker: fix docker image Node.js security issue (325909f), closes #7445
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
deps: update swagger-client to v3.14.1 (c6d5987), closes #7436
Refs https://github.com/swagger-api/swagger-ui/issues/7341
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
fixed most of the security vulnerabilites in dependency tree
Refs https://github.com/swagger-api/swagger-ui/issues/7341
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
We see this release as a breaking change given we will be dropping support for any older versions of React and Redux. Refs https://github.com/swagger-…
The primary goal for v4 release is to bring these libraries to newest possible versions:
We see this release as a breaking change given we will be dropping support for any older versions of React and Redux. Refs https://github.com/swagger-api/swagger-ui/issues/7341
More information in pre-release article: https://swagger.io/blog/api-design/what%E2%80%99s-ahead-for-swaggerui-v4-and-swaggereditor-v4/
highlight-code: handle mousewheel events properly (#7554) (0fc429f), closes #7497
fix issue with highlight code scrolling causing console error
<wbr> (#7516) (f88334a), closes #7513a11n: provide proper a11n for response example tabs (#7464) (8ffb1ae), closes #7463 #7350
Dockerfile: fix security issue in docker image (3c9061e), closes #7445
build-security: do not expose hostname to build framents (#7491) (fdef4ea), closes #7446
js-yaml: update our main YAML parser to v4.1.0 (no esprima anymore in bundle) (3248428), closes #6804
deps: bump swagger-client to v3.14.1 (#7440) (8daf4e4), closes #7436
sample-gen: parameter array missing items fallback (#7376) (de3d063), closes #7375
oas3: Show file upload for schema binary format (#7325) (13c110a), closes #5636
name (#7123) (3a0f72f)Swagger UI now requires Node.js v12. Node.js v10 has reached its EOL on 30-04-2021. Documentation has been updated in this PR #7359
wrapComponents: new chain configuration option
legacy, with an opt-in setting for chain. In a future version, this configuration option will toggle to chain as default, as it is the intended fixed correct behavior. If your application expects and/or requires the legacy option, please update your application accordingly. If your application is agnostic towards the either chain or legacy, no change is needed.authorization: include oauth endpoint description
swagger-ui@3.47.0 was a valid but incomplete release. This release should contain downstream release jobs.
swagger-ui@3.47.0 was a valid but incomplete release. This release should contain downstream release jobs.
remove node_native option from request snippets plugin
sample-gen: infer implicit type and validation constraint types
sample gen should incorporate schema validation constraint
info: use externalDocsUrl check to render Link
use example gen for multiple example value retainer examples
swagger-cllient: version bump to 3.13.1
swagger-ui-react: src filename extension to transpile
One column per quarter.