Specification extensions

While the OpenAPI specification tries to accommodate most use cases, additional data can be used to extend the specification and augment its functionality. These additional properties are known as specification extensions (previously called "vendor extensions"). The extension properties are implemented as patterned fields that start with the x- naming convention.

Redocly has implemented a number of specification extensions to help you enrich your API documentation and adapt your OpenAPI definitions to different scenarios. This page lists specification extensions currently supported by Reference docs and Redoc.

The specification extensions are grouped according to the element(s) of the OpenAPI specification that they extend. Specification extensions can only be used in the sections of your OpenAPI definition that support them - for example, you can't use an extension that modifies the info object inside the tag object.

Select the name of a specification extension in the list to read more on how to use it.

Supported specification extensions by object

OAS root/Swagger object

Extend the OpenAPI Root Object.

Info object

Extend the OpenAPI Info Object.

Tag object

Extend the OpenAPI Tag Object.

Operation object

Extend the OpenAPI Operation Object.

Parameter object

Extend the OpenAPI Parameter Object.

Response object

Extend the OpenAPI Response Object.

Schema object

Extend the OpenAPI Schema Object.

Security schemes object

Extend the OpenAPI Security Scheme Object.

Tip

Learn about how to use specification extensions for other purposes such as hiding an API path, operation, or schema property.