> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/blocks/basic/custom-liquid.md).

# Custom liquid

Adds your own Liquid code or an app snippet inside a section's layout, with size and style controls like a Group.

The Custom liquid block places Liquid code, such as an app snippet or a small customization, inside a section next to your other blocks. It's different from the **Custom liquid** section, which adds the code as a separate section of its own.

{% hint style="info" %}
**Where to find it:** In the theme editor (**Customize**), open a Custom, Gallery, Storytelling, Contact, Collection links or Page section, click **Add block**, and choose **Custom liquid**.
{% endhint %}

### 1. What you can do

With the Custom liquid block, you can:

* Add an app snippet or other Liquid code alongside headings, images and products in the same section
* Control how much space the code takes with **Width** and **Height**, separately on mobile
* Give the code its own color scheme, background color or background media

### 2. How to add a Custom liquid block

{% stepper %}
{% step %}
**Click the section**

In the Theme Editor (Customize), click a [custom section](https://ursus-ecom.gitbook.io/arctos-theme/section-templates/section.md): Custom, Gallery, Storytelling, Contact, Collection links or Page.
{% endstep %}

{% step %}
**Add the block**

Click **Add block** and select **Custom liquid**.
{% endstep %}

{% step %}
**Paste your code**

Paste the code into **Liquid code**. App developers usually give you this snippet.
{% endstep %}

{% step %}
**Adjust the settings**

Set the size and style using the settings described below.
{% endstep %}

{% step %}
**Save your changes**

Click **Save**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The theme doesn't check what your code does. Code that breaks the page layout or loads slowly affects the whole section, so test it on a duplicate theme first.
{% endhint %}

### 3. Block settings

<details>

<summary>Content</summary>

<table><thead><tr><th width="140">Setting</th><th width="130">Options</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Liquid code</strong></td><td>Code field</td><td>The Liquid, HTML or app snippet to output. The block shows nothing when this field is empty.</td></tr></tbody></table>

</details>

<details>

<summary>Size</summary>

The code fills the block, so these settings decide how much room it gets.

<table><thead><tr><th width="140">Setting</th><th width="130">Options</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Width</strong></td><td><ul><li>Fit</li><li>Fill</li><li>Custom</li></ul></td><td><strong>Fill</strong> (default) takes the available width. <strong>Fit</strong> shrinks to the content. <strong>Custom</strong> sets a width in <strong>Percent</strong> (0–100%, default 100%) or <strong>Pixel</strong> (0–2000px, default 700px) with <strong>Unit</strong>.</td></tr><tr><td><strong>Height</strong></td><td><ul><li>Fit</li><li>Fill</li><li>Custom</li></ul></td><td><strong>Fit</strong> (default) follows the content height. <strong>Fill</strong> takes the available height. <strong>Custom</strong> sets a height in <strong>Percent</strong> (0–100%) or <strong>Pixel</strong> (0–2000px, default 700px).</td></tr><tr><td><strong>Custom on mobile</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Turn on to set a separate mobile <strong>Width</strong> and <strong>Height</strong> (both default to <strong>Fit</strong>), with the same options.</td></tr></tbody></table>

</details>

<details>

<summary>Style</summary>

<table><thead><tr><th width="140">Setting</th><th width="130">Options</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Inherit color scheme</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>On (default) uses the section's colors. Turn it off to pick a <strong>Color scheme</strong> from <a href="https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/colors.md">Theme settings > Colors</a>.</td></tr><tr><td><strong>Custom background</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Turn on to choose a <strong>Background</strong>: <strong>None</strong>, <strong>Color</strong> (Solid or Gradient) or <strong>Media</strong> (an image or video, with <strong>Show different media on mobile</strong>, an optional <strong>Overlay</strong>, and <strong>Enable parallax effect</strong>).</td></tr></tbody></table>

</details>
