Skip to content
Last updated

Migration from Redoc 2.x to 3.x

Configuration options changes

The following tables show the changes in configuration options between Redoc 2.x and the newest Redoc 3.x configuration.

Feature/OptionOld Interface (Options)New Interface (Options)
themeResolvedThemeInterfaceRemoved
scrollYOffset() => number() => number
hideHostnamebooleanRemoved
expandResponses{ [code: string]: boolean } |'all'Removed
requiredPropsFirstbooleansortRequiredPropsFirst: boolean
sortPropsAlphabeticallybooleanRemoved
sortEnumValuesAlphabeticallybooleanRemoved
sortOperationsAlphabeticallybooleanRemoved
sortTagsAlphabeticallybooleanRemoved
nativeScrollbarsbooleanRemoved
pathInMiddlePanelbooleanRemoved
hideDownloadButtonsboolean | nullboolean | null
downloadDefinitionUrlstringdownloadUrls?: DownloadUrlsConfig
disableSearchbooleanRemoved
onlyRequiredInSamplesbooleanboolean
generatedPayloadSamplesMaxDepthnumbergeneratedSamplesMaxDepth: number
showExtensionsboolean | string[]string | string[] | boolean
hideSingleRequestSampleTabbooleanRemoved
hideRequestPayloadSamplebooleanRemoved
menuTogglebooleanRemoved
jsonSampleExpandLevelnumberjsonSamplesExpandLevel: number
enumSkipQuotesbooleanRemoved
hideSchemaTitlesbooleanboolean
hideSecuritySectionbooleanRemoved
showSecuritySchemeTypebooleanRemoved
simpleOneOfTypeLabelbooleanRemoved
payloadSampleIdxnumberRemoved
expandSingleSchemaFieldbooleanRemoved
schemaExpansionLevelnumberschemasExpansionLevel: number | undefined
allowedMdComponentsRecord<string, MDXComponentMeta>Removed
expandDefaultServerVariablesbooleanRemoved
maxDisplayedEnumValuesnumbernumber
ignoreNamedSchemasSet<string>Set<string>
unstable_ignoreMimeParametersbooleanRemoved
hideSidebarbooleanboolean
hideLoadingbooleanboolean
hidePropertiesPrefixbooleanboolean
hideSchemaPatternbooleanRemoved
schemaDefinitionsTagNamestringstring
minCharacterLengthToInitSearchnumberRemoved
showWebhookVerbbooleanRemoved
showObjectSchemaExamplesbooleanRemoved

Summary of changes

  • Renamed Options: Some options have been renamed for clarity or alignment with their functionalities, such as generatedPayloadSamplesMaxDepth to generatedSamplesMaxDepth.
  • Removed Features: Several options related to UI customizations and response handling have been removed.
  • Unchanged Options: Some options remain unchanged, indicating their continued relevance in the new configuration.
  • New Options: The new interface introduces several options, suggesting new functionalities or approaches.