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.
swagger-ui-react: avoid babel output in build fragments (#9194) (5dbfc1b), closes #9192
swagger-ui-react: fix build scripts and allow releasing
Your coding agent can read these notes before it upgrades. Set up the MCP server →
expose plugins and presets on SwaggerUI global symbol (#9189) (edd1153), closes #9188
info: indicate OpenAPI 2.0 definition version
swagger-ui-react: fix corrupted exports field from package.json (#9144) (6aa1b44), closes #9143
syntax-highlighter: add light variant called "idea"
syntax-highlighter: add light variant called "idea" (#8938) (1b6391c)
WARNING: this release replaces failed release of SwaggerUI@5.4.0.
Nothing published for this version
request-body: access data of request body in safe way
icons: allow SVG icons to receive arbitrary props (#9106) (733e51a), closes #9094
docker: update libtiff to non-vulnerable version
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
ci: add ga --tag alpha for swagger-ui-react next
WARNING: this release was triggered by mistake, and should have been released via V5 release channel.
ci: add github actions build step
WARNING: this release was triggered by mistake, and should have been released via V5 release channel.
WARNING: this release was triggered by mistake, and should have been released via V5 release channel.
WARNING: this release was triggered by mistake, and should have been released via V5 release channel.
deps: move patch-package to prod deps for ci
patch-package: temporarily remove postinstall hook
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
One column per quarter.