---
title: UnsupportedDocTag
description: Ensures LiquidDoc is only used within snippet files.
source_url:
  html: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/unsupported-doc-tag
  md: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/unsupported-doc-tag.md
api_name: liquid
---

# Unsupported​Doc​Tag

The `doc` tag can only be used within a liquid snippet file.

***

## Examples

The following examples contain code snippets that either fail or pass this check.

### ✗ Fail

The following example shows an invalid use of the `doc` tag:

## sections/section.liquid

```liquid
{% doc %}
  @param {string} some_str
{% enddoc %}
```

### ✓ Pass

The following example shows a valid use of the `doc` tag with a single parameter:

## snippets/snippet.liquid

```liquid
{% doc %}
  @param {string} some_str
{% enddoc %}
```

***

## Options

The following example contains the default configuration for this check:

```yaml
UnsupportedDocTag:
enabled: true
severity: error
```

| Parameter | Description |
| - | - |
| `enabled` | Whether this check is enabled. |
| `severity` | The [severity](https://shopify.dev/docs/storefronts/themes/tools/theme-check/configuration#check-severity) of the check. |

***

## Disabling this check

Disabling this check isn't recommended.

***