> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Theme Check

> How CodeRabbit handles Shopify Theme Check for Liquid theme files.

[Shopify Theme Check](https://shopify.dev/docs/themes/tools/theme-check) is a linter for Shopify themes and Liquid files. CodeRabbit's configuration reference pins Shopify CLI version 4.1.0 and Shopify Theme version 3.58.2, but CodeRabbit currently skips Shopify Theme Check because the CLI is not installed in the sandbox tools image.

## Files

Shopify Theme Check applies to changed files with the `.liquid` extension when the runner is available.

## Configuration

Shopify Theme Check is enabled by default. You can disable it in `.coderabbit.yaml`:

```yaml .coderabbit.yaml lines theme={null}
reviews:
  tools:
    shopifyThemeCheck:
      enabled: false
```

When the runner is available, CodeRabbit requires one of these configuration files:

* `.theme-check.yml`
* `.theme-check.yaml`

CodeRabbit also requires the standard Shopify theme directory structure at the project root:

* `assets/`
* `config/`
* `layout/`
* `locales/`
* `sections/`
* `snippets/`
* `templates/`

## Security policy and restrictions

Shopify Theme Check runs inside the CodeRabbit sandbox when the runner is available. CodeRabbit invokes `shopify theme check` with JSON output and the detected `.theme-check.yml` or `.theme-check.yaml` file.

## When we skip Shopify Theme Check

CodeRabbit will skip running Shopify Theme Check when:

* The Shopify CLI is unavailable in the sandbox tools image.
* No `.liquid` files are changed in the pull request.
* The repository does not have the required Shopify theme directory structure.
* No config file is found (`.theme-check.yml` or `.theme-check.yaml`).
* Shopify Theme Check is already running in GitHub workflows.

## Validation Rules

When the runner is available, CodeRabbit reports Shopify Theme Check offenses with `error` or `warning` severity. CodeRabbit filters out the `UndefinedObject` and `MissingTemplate` checks.

## Links

* [Shopify CLI GitHub Repository](https://github.com/Shopify/cli)
* [Shopify CLI Theme Documentation](https://shopify.dev/docs/api/shopify-cli/theme)
* [Theme Development Requirements](https://shopify.dev/docs/themes/store/requirements)