Added x-keywords extension support for OpenAPI documents to boost or exclude search terms through keywords.
- Realm
- Reef
- Revel
- Redoc
- Reunite
Next release
Try the "next" release candidate or wait until it is promoted to the latest version at the beginning of each month
Latest release
Features
Added
connect-mcpMarkdoc tag.Added support for configuring mock server settings at the product level.
Added Ask AI floating action button to trigger AI Search. Deprecated
search.aiconfig option and replaced it withaiAssistant.Added a possibility to send feedback for AI Search responses.
Added page actions that allow to connect to the MCP server via VSCode and Cursor.
Added support for
discriminator.defaultMappingin OpenAPI 3.2.0.Added
projectTitleparameter toseoconfiguration to append project name to page titles.Added
frontmatterTranslateutility to localize React front matter.Added
additionalPropstonavbar,sidebar, andfooteritems to enable adding custom properties.Added support for anchor links to the
tabsMarkdoc tag.Updated CSS styles for the
tagcomponent.
Fixes
Fixed a path prefix issue for static assets from
staticdirectory.Fixed an issue where disabling
mockServerdid not remove its paths.Fixed an issue where valid links caused link checker errors for API description file download links.
Fixed incorrect paths in anchor links when
REDOCLY_PREFIX_PATHSwas used.Fixed an issue where scorecard level rules were not overridden with target rules.
Fixed an issue where the link checker incorrectly reported links with configured wildcard redirects as broken.
Fixed navigation issues in sidebar, product, and version pickers for projects using path prefixes.
Fixed an issue where static assets were served without path prefix when it was enabled.
Updated
@redocly/openapi-coreto version2.10.0.Fixed an issue where renaming route paths and changing API functions required full restart in the preview mode.
Fixed security vulnerability
CVE-2025-62610.Fixed a conflict in the router between MCP server and file with the same name in the root directory.
Fixed an issue where API output files listed in the
ignoreconfiguration were not excluded.Fixed an issue in AsyncAPI docs where
schemaFormatwith$refin message payloads caused crashes.Fixed an issue where the sidebar didn't preserve its state between reloads.
Fixed an issue where component ejection failed with npm installations.
Fixed an issue where search didn't parse Markdoc variables and partials.
Fixed an issue where URLs in the sitemap didn't respect the path prefix.
Fixed an issue that caused redirects to not work in locales.
Fixed card links leading to incorrect locations in GraphQL and AsyncAPI docs.
Fixed an issue where navigation actions could not be disabled for a page using front matter.
Fixed an issue where link checker reported HTML
atag valid links in project under path prefix.Improved layout of the tabs component.
Improved AI assistant usability on mobile devices.
Content slugger no longer takes media assets and ignored files into account.
Fixed an issue where page actions appeared for each
partialMarkdoc tag on a page.Fixed an issue where
oneOftitles were overridden by the parent schema's title.Fixed an issue where servers in OpenAPI documentation pages were not inherited from the root server.
Fixed malformed operation link URL in Replay.
Updated
openapi-samplerfrom version 1.6.1 to 1.6.2.Updated
@redocly/openapi-coreand@redocly/respect-coreto version2.10.0.Changed Ask AI button default icon from
redoclytosparkles.Fixed an issue where the navbar link to the root ("/") path in projects under path prefix was not active.
Fixed the
Cardcomponent missing list bullets and limited Markdown support.Improved Download panel height to fit the content size for Graphql docs.
Previous releases
Fixes
Synchronized date range filters between feedback export modal and feedback list.
Fixes
Updated
@redocly/openapi-coreand@redocly/clito version2.10.0.
Features
Improved text color of disabled items in the file context menu.
Fixes
Fixed file upload for allowed folders with RBAC.
Updated
@redocly/openapi-coreand@redocly/clito version2.7.0.Fixed issue that allowed deletion of protected files from the file tree using keyboard shortcuts.
Fixes
Fixed an issue where successive sidebar items were not activated when users were scrolling API document pages.
Fixes
Renamed the
get-full-definitionMCP tool toget-full-spec-document.Fixed visual issue in
x-mcpoverview section.
Features
Added front matter keywords configuration to boost or demote search rankings for Markdown pages through includes/excludes lists.
Added validation for React pages to catch runtime errors during the build process.
Added
openapi.showSchemaCatalogLinksconfiguration option to display links to schemas and requests on an OpenAPI page. These links can be used as$refvalues in other OpenAPI files within the same project.Added support for
_partialsfolders at any directory level. Added glob pattern support for thepartialsFoldersconfiguration.Added
showBuiltInScalarsandshowBuiltInDirectivesoptions to control visibility of built-in GraphQL scalars and directives.Added validation to ensure
residencystarts withhttp://orhttps://.Added built-in MCP server to expose API docs to AI assistants.
Added support for OpenAPI 3.2.0 security updates:
deprecatedandoauth2MetadataUrlfields,deviceAuthorizationflow, and code samples generation for device authorization flow.Added support for the OpenAPI 3.2.0
servers.nameproperty.Improved memory efficiency when creating search indexes, reducing build failures due to out-of-memory errors on large projects.
Improved heading anchor ID generation by removing dots and slashes to create cleaner URL fragments.
Added path prefix support for HTML
hrefattributes.Added support to configure
Replaywith dynamic API data.Added support for the
x-mcpvendor extension in OpenAPI to render MCP server documentation.Added the OpenAPI
infoobject to theuseConfigureReplaycontext.Added persistence for user-created environments in
Try itbetween page reloads.
Fixes
Fixed an issue where environment variables were not resolved inside
redocly.yamlwhen building OpenAPI documents.Fixed an issue where tooltips could obscure the parent UI element.
Fixed responses without parameters not being included in
llms.txt.Fixed search issue where queries with text enclosed in backticks in API descriptions returned no results.
Fixed display of active element in
code-grouptag after page refresh.Fixed an issue with displaying multiple active elements in a
code-grouptag when they had the same names.Improved error message for broken sidebar links in front matter.
Fixed search dialog results being unscrollable on small screens. Fixed advanced search filters overflowing the viewport on small screens.
Fixed an issue where
x-rbacandmarkdocdid not work in Swagger (Open API 2.0.x) descriptions.Improved build logs by separating AI Search and
llms.txtmessages.Fixed an issue where external links in the sidebar appeared as active.
Added
iconoption to sidebarseparator.Fixed an issue that prevented focusing the first section of the API documentation when content was minimal.
Fixed an issue where following an anchor link did not cause the page to scroll to the target heading.
Fixed duplicated descriptions in
oneOfoptions.Fixed an issue where the AI search icon shrank with long queries; the icon maintains its size and the query text wraps correctly.
Fixed missing
Expand Allbutton in requests usingoneOf.Fixed an issue with the sidebar active item when using
REDOCLY_PREFIX_PATHSand the OpenAPI document was in the root directory.Fixed partial tags not rendering correctly when containing schema components such as OpenAPI examples and code samples.
Fixed security vulnerability CVE-2025-59139 in
bodyLimitmiddleware by upgradinghonoto v4.9.7.Fixed an issue where the API Catalog displayed only one API from versioned subfolders.
Fixed
replay-openapiMarkdoc tag not updating until page refresh.Normalized trailing slash handling in SSR to prevent hydration mismatches.
Fixed double prefixes in image URLs.
Fixed an issue where the OpenAPI download URLs did not work with the
outputproperty if the output path was in the/static/_spec/directory.Fixed an issue where plugins writing data to the files in project interfered with the processing causing link checker errors.
Removed empty catalog sidebar when no filters were configured.
Enhanced
JsonViewerwithcontrolsprop to manageCodeBlockheaders; removedhideHeaderprop.Added handling for special characters in query strings.
Fixed processing of relative OAuth 2.0 authorization and token URLs during the OAuth flow. Parsed OAuth 2.0 scopes from the API definition and displayed them in the security tab.
Features
Show user-friendly messages for credential validation failures, missing repositories, and branch errors when interacting with Git providers.
Features
Added ability to fetch and search project branches on the Branch Deploy Strategy page.