# `schemasExpansionLevel`

The `schemasExpansionLevel` option controls the expansion level of schemas in OpenAPI reference documentation.
Set it to `all` to expand all schemas regardless of their level.
Set it to a number to expand schemas up to the specified level.
Required properties are expanded by default to a depth of `4` levels.

## Options

| Option | Type | Description |
| --- | --- | --- |
| schemasExpansionLevel | number \| string \| 'all' | Sets the default expand level for schemas. Use `all` to expand all levels. There is no default value for schemas expansion. If this option is not configured, only the required properties are expanded to a depth of `4` levels. |

## Examples

The following example expands schemas up to 4 levels deep.

```yaml
openapi:
  schemasExpansionLevel: 4
```

## Resources

- **[OpenAPI configuration](/docs/platform/config/openapi)** - Complete guide to OpenAPI configuration options for customizing API reference documentation
- **[OpenAPI Specification](https://spec.openapis.org/oas/latest.html)** - Official OpenAPI Specification documentation for understanding API description standards
- **[OpenAPI visual reference](https://redocly.com/learn/openapi/openapi-visual-reference)** - Visual guide to OpenAPI specification structure and schema expansion configuration
- **[Configuration options](/docs/platform/config)** - Explore other project configuration options for comprehensive documentation customization