# unused-directive-definition

Source: https://api-genie.dev/docs/linter/graphql/rules/unused-directive-definition

A rule of the GraphQL linter, which reads GraphQL schemas and operations. Since 0.9.0. In the rulesets: Strict at error, All at error.

This rule checks that the directives defined for schemas are applied in the document.

## Rule details

An unused directive definition is dead code. Directives with executable locations (e.g. `FIELD`) are meant for operations and are not reported.

Turn the rule off when the directives are defined in a file and applied in others.

The rule applies to definitions. An `# apigenie-lint-disable unused-directive-definition` comment on
a node turns it off for the node and everything nested in it; at the top of the file, separated from
the first definition by a blank line, the comment turns it off for the whole file.

## Examples

**Good**.

```graphql
directive @auth on FIELD_DEFINITION
type Query { me: User @auth }
```

**Bad**. The linter reports `Directive '@auth' is defined but never applied`.

```graphql
directive @auth on FIELD_DEFINITION
type Query { me: User }
```
