# Settings

The following is a list of `li-settings` modifiers available in <code class="expression">space.vars.Company</code>. Each modifier provides different input types in the Shopify editor. Shopify also offers additional input types. To use those, refer to the [custom settings attribute documentation](https://docs.liquiflow.app/section-settings/custom-settings).

#### Text Input

This attribute creates a simple string input in the Shopify Theme Editor. The text of the element will be used as the default text of the attribute. The value of the attribute will be used as the label of the setting.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:text = Heading
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FXgze8zdZb6FGgGAe0kVG%2Ftext.png?alt=media\&token=15e444b2-a899-4f24-86f4-aa7a762c6eee)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Textarea Input

This attribute creates a simple string input in the Shopify Theme Editor. The content of the element with this attribute will be used as the default value of the setting in the Shopify Theme Editor. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:textarea = Welcome message
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FDpoyAR9zHJzpkyomdbVa%2Ftextarea.png?alt=media\&token=1e68ebe2-9a7b-4621-bb69-ea29cb8c8626)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Richtext Input

This attribute creates a multi-line text field with basic formatting options in the Shopify Theme Editor. The content of the element with this attribute will be used as the default value of the setting. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:richtext = Heading
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FmpUfI0KvryHslpR3Nn6V%2Frichtext.png?alt=media\&token=17063f7a-c0b7-4daa-87d1-cd3905c69ddc)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Image Input

This attribute creates an image picker field that automatically lists available images from the Files section in the Shopify admin, with the option to upload new ones. The value of the attribute will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:image = Image
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2Fje6fzbPSe344511PiIbG%2Fimage.png?alt=media\&token=034ba386-8aee-4b9f-ad4e-68b9f4c3b0da)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

<details>

<summary>Detailed Documentation</summary>

For a better understanding of what happens behind the scenes, we’ve prepared detailed documentation.

When using the `li-settings:image` attribute (as described above), several changes are made during the conversion process:

* The `<img>` tag is replaced with a Shopify object and the filters `| image_url: width: 1000` and `| image_tag`. This ensures the `<img>` tag is rendered on the live site as [Shopify recommends](https://shopify.dev/docs/api/liquid/filters/image_tag).
* All attributes from the original `<img>` element (e.g. `class`, `loading`) are passed into the `image_tag` filter, for example: `| image_tag: loading: 'eager', class: 'more_image'`.
* The object is wrapped in a condition to check whether an image is applied. By default, if no image is set, the Webflow image is used as a placeholder.

Here’s how the theme builder now handles it:

<pre data-title="Webflow" data-full-width="false"><code><strong>&#x3C;img class="more_image" li-settings:image="Image" src="image/logo.svg" loading="eager" >
</strong></code></pre>

{% code title="Shopify" %}

```
{% if section.settings.image_image %}
        {{ section.settings.image_image | image_url: width: 1000 | image_tag: loading: 'eager', class: 'more_image' }}
{% else %}
        <img src="{{'logo.svg' | asset_url }}" class="more_image" >
{% endif %}
```

{% endcode %}

**Placeholder Tag**

If you don’t want to use the Webflow image as a placeholder, you can override it with the | placeholder: 'detailed-apparel-1' filter, like this:

{% code title="Webflow" fullWidth="false" %}

```
li-settings:image = Image | placeholder: 'detailed-apparel-1'
```

{% endcode %}

{% code title="Shopify" %}

```
{% if section.settings.image_image %}
        {{ section.settings.image_image | image_url: width: 1000 | image_tag: loading: 'eager', class: 'more_image' }}
{% else %}
        {{ 'detailed-apparel-1' | placeholder_svg_tag: 'more_image' }}
{% endif %}
```

{% endcode %}

This now references the Shopify placeholder library. You can find a list of all available placeholders [here](https://shopify.dev/docs/api/liquid/filters/placeholder_svg_tag).

**Image size**

To control the size of the image loaded from the Shopify server, you can use the `| image_url` filter. Simply specify the desired height or width, and it will override the default `| image_url: width: 1000`.

{% code title="Webflow" fullWidth="false" %}

```
li-settings:image = Image | image_url: width: 400
```

{% endcode %}

{% code title="Shopify" %}

```
{% if section.settings.image_image %}
        {{ section.settings.image_image | image_url: width: 400 | image_tag: loading: 'eager', class: 'more_image' }}
{% else %}
        <img src="{{'logo.svg' | asset_url }}" class="more_image" >
{% endif %}
```

{% endcode %}

**Adding attributes to the image tag**

To add more attributes to the image tag, simply place them on the `<img>` tag as shown above — they’ll be automatically included in the `image_tag`.

You can also reference variables or objects inside the `image_tag`. To do this, just add them as filters on your `li-settings:image` element, like this:

{% code title="Webflow" fullWidth="false" %}

```
li-settings:image = Image | id: product.title
```

{% endcode %}

{% code title="Shopify" %}

```
{% if section.settings.image_image %}
        {{ section.settings.image_image | image_url: width: 400 | image_tag: loading: 'eager', class: 'more_image', id: product.title }}
{% else %}
        <img src="{{'logo.svg' | asset_url }}" class="more_image" >
{% endif %}
```

{% endcode %}

</details>

#### url Input

This attribute creates a field for entering external URLs or relative paths from your Shopify theme manually. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:url = Button Link
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FNpzNVC89CSat4l6DJOzn%2Furl.png?alt=media\&token=9d93ad14-5302-4538-9f13-11e856712920)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Checkbox

The checkbox attribute displays a checkbox input. It’s useful for enabling or disabling features, such as showing an announcement bar. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:checkbox = Show announcement
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2F3zf7nay50AyIKytvIdxj%2Fcheckbox.png?alt=media\&token=78be82f0-4e0c-4218-bf7c-49ba4bc5476a)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Collection Input

A collection setting displays a picker field that automatically lists all available collections in the store. Apply this to a product item to iterate over the collection products. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:collection = Collection
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FmY0Nxa7GO1x1nNdaySAs%2Fcollection.png?alt=media\&token=7602d113-bbb1-407c-8066-74c536052dbd)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Blog

A blog setting displays a picker field that automatically shows all available blogs in the store. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:blog = Blog
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2Fe4LTuoeF6mnHsWa3VoSz%2Fblog.png?alt=media\&token=512426ff-17f6-45d9-83de-f7bd8a755ced)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Article

An article setting displays a picker field that automatically lists all available articles in the store. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:article = Article
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FWgC2qT7IheRZ3wcEjIgV%2Farticle.png?alt=media\&token=081413e0-ad5c-4b3b-a07e-ed9f9f91e9f9)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### Product

A product setting displays a picker field that automatically lists all available products in the store. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:product = Product
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2Fj5IyJTfWbRK0lKzTGVfN%2Fproduct.png?alt=media\&token=3d727927-598d-481c-a638-df6699154a11)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

#### HTML Input

An html setting provides a multi-line text field where you can enter HTML markup. The value of the attribute itself will be used as the setting’s label in the editor.

{% columns %}
{% column width="50%" %}
{% code title="Webflow" %}

```
li-settings:html = Video embed
```

{% endcode %}
{% endcolumn %}

{% column %}
{% hint style="success" %}
Shopify

![](https://497333298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FheMDp56vLoqqIp7IZZ2W%2Fuploads%2FyN9vjO0WzQEE1OSNQ12N%2Fhtml.png?alt=media\&token=f77e385a-02a9-44ca-8622-52ad84b2ee2a)
{% endhint %}
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
For even more advanced settings use our [custom settings attribute](https://docs.liquiflow.app/section-settings/custom-settings).
{% endhint %}
