# tags-unique

Source: https://apigenie.pl/docs/linter/openapi/rules/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**.

```yaml
tags:
  - name: User
  - name: Product
```

**Bad**.

```yaml
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.

## Automatic fixes

When invoked with `--fix`, this rule removes case-insensitive duplicates with
identical metadata, and removes empty duplicates in favor of an informative
definition. Conflicting descriptions or external documentation remain manual.

## Compatibility

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