> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.