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 3 days ago
01 Oct 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
371 releases · first in 2017
docker: update libtiff to non-vulnerable version
One column per quarter.
swagger-ui-react: fix default value for spec prop (#9025) (990ff7d), closes #8976
spec: add new specJS selector (#8936) (a6c2745), closes #8606
NOTE: this release comes with performance enhancements that allow to display huge OpenAPI 3.1.0 definitions in SwaggerUI.
json-schema-2020-12: add support for deprecated keyword (#8648) (aed6bb3), closes #8513
v5.0.0 release brings support for OpenAPI 3.1.0 specification. Support for OpenAPI 3.1.0 has been introduced in fully backward compatible way.
PORT_IPV6 environment variable (https://github.com/swagger-api/swagger-ui/pull/8878)Info.summary field, closes #8486License.identifier field, closes #8487OpenAPI.webhooks below the paths, closes #8488, #8489Info.summary field as text, not as markdownoas31 plugin where all OpenAPI 3.1.0 related features are concentrated (#8474). oas31 plugin creates clear internal/public API around SwaggerUI OpenAPI 3.1.0 features.This release brings support for generating examples from JSON Schema 2020-12. Some rendering enhancements have also been added. JSON Schema 2020-12 is
This release brings support for generating examples from JSON Schema 2020-12. Some rendering enhancements have also been added. JSON Schema 2020-12 is default JSON Schema dialect for OpenAPI 3.1.0 specification.
introduce samples framework for JSON Schema 2020-12 (ac3b69f), closes #8577
PORT_IPV6 environment variable (https://github.com/swagger-api/swagger-ui/pull/8878)auth: persist cookie based apiKey in document.cookie (#8689) (7ac9a8f), closes #8683
This release brings full support for rendering JSON Schema 2020-12, which comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification.
This release brings full support for rendering JSON Schema 2020-12, which comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification.
components.schemas:
Path Operations:
Webhooks Operations:
This release brings full support for rendering JSON Schema 2020-12, that comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification. This
This release brings full support for rendering JSON Schema 2020-12, that comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification. This new JSON Schema 2020-12 renderer is currently utilized only in bottom section of SwaggerUI which renders OpenAPI 3.1.0 components.schemas field. Below is a preview of how the rendered JSON Schema 2020-12 looks like.
Supported vocabularies in new JSON Schema 2020-12 renderer:
json-schema-2020-12: add support for deprecated keyword (#8648) (aed6bb3), closes #8513
This release brings support (still partial) for rendering JSON Schema 2020-12, that comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification. This new JSON Schema 2020-12 renderer is currently utilized only in bottom section of SwaggerUI which renders OpenAPI 3.1.0 components.schemas field. Below is a preview of how the rendered JSON Schema 2020-12 looks like.
Supported vocabularies in new JSON Schema 2020-12 renderer:
json-schema-2020-12: add support for const keyword (#8622) (8e4fde5), closes #8513
oas31: resolve schemas in 'Schemas section' only if expanded (#8616) (a8771e7), closes #8606
json-schema-2020-12: enable sub-tree expansion performance optimization (#8609) (37e8f00), closes #8606
This release brings partial support for rendering JSON Schema 2020-12, that comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification. Th
This release brings partial support for rendering JSON Schema 2020-12, that comes as a default JSON Schema dialect for OpenAPI 3.1.0 specification. This new JSON Schema 2020-12 renderer is currently utilized only in bottom section of SwaggerUI which renders OpenAPI 3.1.0 components.schemas field. Below is a preview of how the rendered JSON Schema 2020-12 looks like.
Supported vocabularies in new JSON Schema 2020-12 renderer:
oas31: fix rendering Path Items containing schemas with cycles (#8547) (0fabcaf), closes #8537
oas31: add relative reference support for baseDoc option (#8533) (7132e16), closes #8525
oas31: detect user request body edits in OpenAPI.paths (#8500) (5c11bb5), closes #8498
oas31: fix recursive bug in hasUserEditedBody selector wrapper (#8499) (25edb23), closes #8498
decode model schema name on model component (#8400) (44e2700), closes #5626
add support for rendering Info.summary field, closes #8486
Info.summary field, closes #8486License.identifier field, closes #8487OpenAPI.webhooks below the paths, closes #8488, #8489Info.summary field as text, not as markdownoas31 plugin where all OpenAPI 3.1.0 related features are concentrated (#8474). oas31 plugin creates clear internal/public API around SwaggerUI OpenAPI 3.1.0 features.integrate swagger-client@3.19.1
This release supersedes 4.16.0-alpha.3, 4.16.0-alpha.2 and 4.16.0-alpha.1
oas3: fix deep linking for Callbacks (#8691) (58b460d), closes #8556
response-body: remove download button when content is empty
reserve latest tag for swaggerapi/swagger-ui docker image for 4.x.y release channel
docker: enable IPv6 explicitly by env variable (#8449) (51f8ccb), closes #8447 #8437
integrate swagger-client@3.19.0-beta.8 (#8431) (1bb4daf), closes #8401
NOTE: SwaggerUI@4.17.0 comes with swagger-client@3.19.0-beta.8, which integrates with ApiDOM. ApiDOM has some optional dependencies that might fail to install, but you can safely ignore the failures, as those dependencies are optional.
integrate swagger-client@3.19.0-beta.7 (#8426) (d3a1e94), closes #8418
integrate swagger-client@3.19.0-beta.7 (#8415) (d293555), closes #8401
deps: move patch-package to prod deps for ci
remove IE7 star property hack in tachyons-sass via patch-package (#8266) (073c31a), closes #8243
ui: handle missing schema reference case for discriminant definitions
oauth2: only display scopes relevant for current endpoint (#8229) (9457566), closes #8219
this release fixes following SwaggerUI Docker image security vulnerabilities: CVE-2022-32213, CVE-2022-32214, CVE-2022-32215, CVE-2022-35255
xml: render example with oneOf/anyOf
Render external docs links and descriptions
build: mitigate regressions to build framents in v4.13.1 (#8137) (9221ff8), closes #8136
jsdom: cumulative Jest updates with support for TextEncoder/TextDecoder
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.
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →