tags-unique

This rule checks for schemas that define multiple tags with the same name, considering tag names as case-insensitive.

Rule Details

Duplicate tag names can lead to confusion and misinterpretation of the API’s structure.

The tags-unique rule is designed to ensure that all tags defined in a schema have unique names. Names are considered case-insensitive.

Configuration

None.

Examples

Good.

tags:
  - name: User
  - name: Product

Bad.

tags:
  - name: user
    description: First tag
  - name: User
    description: Is this another tag, or a typo ?

When Not to Use It

We recommend to always enable this rule.

Compatibility

This rule is compatible with all OpenAPI 3.x versions.