---
title: LiquidFreeSettings
description: >-
  A validation that identifies when a theme is using the Liquid tag within
  settings values.
source_url:
  html: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/liquid-free-settings
  md: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/liquid-free-settings.md
api_name: liquid
---

# Liquid​Free​Settings

Ensures that themes aren't using the `{% liquid %}` tag within `Settings` values. `Settings` values can't contain Liquid logic. This check only flags `{%` `%}` logic tags. Output tags (`{{ }}`) in setting values aren't affected.

***

## Examples

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

### ✗ Fail

In the following example, the `{% liquid %}` tag is used within a `Settings` value:

```liquid
{% schema %}
{
  "name": "Section name",
  "settings": [
    {
      "id": "input_with_logic",
      "type": "text",
      "label": "Input with Logic",
      "default": "Hello {% if user %} User {% endif %}!"
    }
  ]
}
{% endschema %}
```

### ✓ Pass

In the following example, the `{% liquid %}` tag isn't used within a `Settings` value:

```liquid
{% schema %}
{
  "name": "Section name",
  "settings": [
    {
      "id": "input_with_logic",
      "type": "text",
      "label": "Input with Logic",
      "default": "Hello User!"
    }
  ]
}
{% endschema %}
```

Output tags (`{{ }}`) are allowed in setting values. For example, [`color_palette`](https://shopify.dev/docs/storefronts/themes/architecture/settings/input-settings#color_palette) references and [`visible_if`](https://shopify.dev/docs/storefronts/themes/architecture/settings#conditional-settings) conditions both use this syntax:

```liquid
{% schema %}
{
  "name": "Section name",
  "settings": [
    {
      "id": "heading_color",
      "type": "color",
      "label": "Heading color",
      "default": "{{ settings.colors.primary }}"
    }
  ]
}
{% endschema %}
```

***

## Options

The following example contains the default configuration for this check:

```yaml
LiquidFreeSettings:
  enabled: true
  severity: warning
```

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

***
