> For the complete documentation index, see [llms.txt](https://help.brickspacelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brickspacelab.com/keystone/sections/sitewide/custom-liquid.md).

# Custom liquid

### Section overview

The Custom liquid section allows developers to add custom Liquid code directly to their Shopify theme pages. It provides complete flexibility for integrating custom functionality, styling, or dynamic content that isn't covered by standard sections.

#### Common use cases

* Displaying dynamic store information like policies, contact details, or announcements
* Adding custom HTML and CSS that requires Liquid variables
* Integrating third-party widgets or code snippets
* Creating custom layouts that utilize Shopify's Liquid objects and filters

#### Usage tips

* Use proper HTML structure within your Liquid code to maintain accessibility
* Test thoroughly on both desktop and mobile to ensure responsive behavior
* Avoid excessive JavaScript that could impact page performance
* Keep complex Liquid logic organized with appropriate comments
* For security reasons, validate any user inputs before displaying them

### Section settings

| Setting         | Type     | Description                                                                         |
| --------------- | -------- | ----------------------------------------------------------------------------------- |
| Liquid          | Liquid   | Custom Liquid code to render in this section. Defaults to displaying the shop name. |
| Top spacing     | Range    | Controls the padding space above the section content (0-300px).                     |
| Bottom spacing  | Range    | Controls the padding space below the section content (0-300px).                     |
| Color scheme    | Select   | Determines the background and text color combination for the section.               |
| Border color    | Select   | Sets the color of any borders applied to the section (subtle or strong).            |
| Border position | Select   | Controls where borders appear (none, top, bottom, or both top and bottom).          |
| Enable margin   | Checkbox | When enabled, applies horizontal margin to match site layout.                       |
| Visibility      | Select   | Controls whether the section appears on all devices, only mobile, or only desktop.  |

### Block settings

This section does not contain any blocks.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.brickspacelab.com/keystone/sections/sitewide/custom-liquid.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.