OpenAPIExtensions

Tag display names

By default, tag names from your OpenAPI specification become section names in your API Reference. Use the x-displayName extension to control how these section names display in your generated documentation. This is helpful for controlling capitalization and creating user-friendly names.

You can set display names directly in your spec or in an overrides file.

openapi.yml
1tags:
2  - name: task
3    x-displayName: Tasks
4  - name: billing-and-payments
5    x-displayName: Billing and Payments

Alternatively, you can rename sections directly in your docs.yml file.