You can configure Theme Check to override default check options, enable or disable specific checks, or point to your own custom checks. You can make these changes using a [config file](#config-file), disable checks using [comments](#disable-checks-using-liquid-comments), or selectively run checks using command line flags. To learn more about theme check command line flags, refer to [Theme Check commands](/docs/storefronts/themes/tools/theme-check/commands).
## Config file
Add a `.theme-check.yml` file to the root of your theme to override check defaults.
You can generate a new `.theme-check.yml` file using the command `shopify theme check --init`.
You can adjust the following settings:
| Setting | Type | Description |
| --- | --- | --- |
| `root` | `string` | If your theme isn't using the standard theme directory structure, you can provide root path for finding the `templates`, `sections`, and `snippets` directories. For example, If you generate code from a `src` directory, then you should point your Theme Check configuration at your corresponding `dist` directory. |
| `extends` | `string or string[]` | If you want to compose configuration files, or start off the recommended one, you can use the `extends` setting to reference a configuration file. Also supports the following magic settings: `theme-check:all`, `theme-check:recommended`, `theme-check:theme-app-extension`. When multiple configurations are extended; objects are deep merged, arrays are concatenated, and the latest one in the list takes priority. |
| `require` | `string or string[]` | If you want to use a [custom or third party set of checks](/docs/storefronts/themes/tools/theme-check#creating-your-own-checks), then add a CommonJS import path. |
| `ignore` | `string[]` | Exclude directories in the theme from Theme Check. |
| Check settings | `object` | For each check, set `enabled` to `true` or `false`, set the check [severity](#check-severity), set specific `ignore` files and paths for the check, and configure any other check options. If you created a custom check, then you need to enable it using this method.
You can view the default values of check options in the [checks reference](/docs/storefronts/themes/tools/theme-check/checks). |
All settings are optional.