> For the complete documentation index, see [llms.txt](https://uxsmart.gitbook.io/velare/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uxsmart.gitbook.io/velare/customize-your-pages/custom.md).

# Custom

The **Custom** group holds the one block that takes your own code instead of settings. Like every other block here, it is added inside a section rather than placed on a page by itself, so a snippet can sit exactly where it is needed in the layout: between two paragraphs, under a gallery, or at the end of a section.

Use it only when the standard blocks cannot produce what you need. Anything you can build with the [Basic](/velare/customize-your-pages/basic.md) and [Layout](/velare/customize-your-pages/layout.md) blocks stays easier to maintain there, because those settings survive theme updates without anyone reading code.

### How to add a custom block <a href="#how-to-add" id="how-to-add"></a>

{% hint style="success" %}
**Steps:**

1. Go to **Online Store > Themes > Customize**.
2. In the left sidebar, click the section you want to extend.
3. Click **Add block** and choose **Custom Liquid**.
4. Paste your code into **Liquid code**, then check the preview before saving.
   {% endhint %}

*Result:* whatever the snippet outputs is rendered in that spot in the section, in the same position as any other block.

### Blocks in this group <a href="#blocks-in-this-group" id="blocks-in-this-group"></a>

| Block                                                                 | What it does                                                               | Reach for it when                                                                      |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| [Custom Liquid](/velare/customize-your-pages/custom/custom-liquid.md) | Renders your own Liquid, HTML, or app snippet at that point in the section | An app asks you to paste a snippet, or you need output the theme settings do not offer |

### Related pages <a href="#related-pages" id="related-pages"></a>

* [Basic](/velare/customize-your-pages/basic.md): the settings driven blocks to try before reaching for code
* [Layout](/velare/customize-your-pages/layout.md): containers and spacing, which usually remove the need for custom markup
* [Custom CSS](/velare/customize-your-pages/custom-css.md): for styling changes, which belong there rather than in a block


---

# 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://uxsmart.gitbook.io/velare/customize-your-pages/custom.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.