NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2796 most downloaded on npm
[](http://badge.fury.io/js/swagger-ui-dist)
Last release 14 days ago
16 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
370 releases · first in 2017
plugins: make swagger-js wrapActions overridable (#7753) (8ea3cfd), closes #7730
One column per quarter.
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.
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
sample-gen: yaml sample generation
docker: add docker support for persist authorization variable
ux: Disabled Execute button while request is in progress
security fixes applied in highlight.js@10.4.1, node-fetch@2.6.1, and dot-prop@5.3.0
chore: update swagger-js to v3.12.1 which brings better support for $ref resolving
*This is a failed release which is identical to v3.37.0. Please install v3.37.2 instead.*
swagger-ui-react: add support for layout prop
externalDocs url for tags when using swagger v2.0
swagger-client: update to v3.12.0. Fixes nested allOf/oneOf schema resolution in #5194, #5923, #4672
support for showExtensions on Response objects
oas3: switching media types should update schema properties (#6518) (3905fad), closes #6201 #6250 #6476
oas3: switching media types should update schema properties (#6518) (3905fad), closes #6201 #6250 #6476
missing commas in response header values #6183 (#6515) (99fda81)
style: preventing long strings from overflowing (#5934) (#6507) (4b2fddd)
jest: add stub for errActions to prevent unhandled promise rejections #6365 (#6495) (537ad6d)
jest: unknown prop initialValue on input tag (#6506) (1af8678)
deprecate from "new Buffer" to "Buffer.from"
parameter-row: rendering of default/example values of 0 (#6454) (797929f)
syntax-highlighter: configuration for Examples (#6455) (b5e8081), closes #5259
examples multipart array sample generation for items (#6461) (f4bdf2f)
filter: avoid filtering by the strings "true/false" when enabled (#6477) (aa53ec2)
style: inconsistent background colors in code sections (#6472) (1b11d5c)
deprecate from "new Buffer" to "Buffer.from" (#6489) (6c5e91d)
auth: both array and Im.List scopes can be added to redirectURL
Preserve authorization on browser refresh and close/reopen
models view when object key contains deprecated:true (#6371) (d4eea4d), closes #6369
$ (#6354) (89d57fc)entrySeq() to bodyProperties.map() (#6267) (0199b47)operationTag: verify selectedServer exists before invoking
This release is intended to enable npm to include es2015 bundle files. There are no source code changes in this release.
Models: onLoad should check this.props.layoutSelectors method (#6307) (168d0ae), closes #6305
prismjs@1.21.0 (#6312)Additional dependency updates via #6317, #6316, #6313, #6310
Your coding agent can read these notes before it upgrades. Set up the MCP server →