Redoc CE comes with many configuration options to help you customize your API documentation.
Each deployment type has documentation on how to configure options for that type of Redoc CE project. This page lists all the options you can use with Redoc CE.
Versions: 3.x
Redoc CE 3.x supports the following configuration options:
downloadUrlsgeneratedSamplesMaxDepthhideDownloadButtonshidePropertiesPrefixhideSchemaTitlesjsonSamplesExpandLevellayoutmaxDisplayedEnumValuesonlyRequiredInSamplessanitizeschemaDefinitionsTagNameschemasExpansionLevelshowExtensionssortRequiredPropsFirst
Additionally, the following options are available from the previous versions of Redoc CE:
| Option | Type | Description |
|---|---|---|
| skipBundle | boolean | When true, skips the bundle step when building API docs. Use when the description files are provided directly and do not require re-bundling. |
| ignoreNamedSchemas | [string] | Provide a list of schema names to ignore when building docs. |
| scrollYOffset | string | Specifies a vertical scroll-offset in pixels. Use when your docs have fixed positioned elements at the top of the page, such as navbars, headers, etc. |
| hideLoading | boolean | When true, hides the loading animation. Does not apply to CLI-rendered docs. |
| hideSidebar | boolean | When true, hides the left sidebar. |
Example:
downloadUrls:
- title: Download OpenApiDescription
url: 'https://example.com/museum.yaml'
- title: Download OpenApiDescription json
url: 'https://example.com/museum.json'
schemaDefinitionsTagName: Schemas
hideSidebar: true
jsonSamplesExpandLevel: 1
generatedSamplesMaxDepth: 3
hideDownloadButtons: false
hideLoading: true
hideSchemaTitles: false
maxDisplayedEnumValues: 3
onlyRequiredInSamples: true
routingBasePath: docs/api
schemasExpansionLevel: 3
sortRequiredPropsFirst: true
showExtensions: true
sanitize: true
skipBundle: false
ignoreNamedSchemas: ['java.io.ObjectStreamField']
layout: three-panel
scrollYOffset: 100
hidePropertiesPrefix: false- Redoc CE deployment guide - Learn about the different ways you can deploy API documentation with Redoc CE
- Use the Redoc CE Docker image - Deploy API documentation with Docker
- Use Redoc CE in HTML - Deploy API documentation embedded in an HTML page
- Use Redoc CE React component - Deploy API documentation in a React page
- Migration from Redoc CE 2.x to 3.x - Migrate Redoc CE configuration to version 3.x
- Telemetry - Learn about the telemetry used in Redoc CE