> For the complete documentation index, see [llms.txt](https://hollow-peak.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hollow-peak.gitbook.io/docs/page-builder/block-reference.md).

# Block Reference

Every block, what it does, and its options.

30 blocks in eight groups. Blocks belonging to a switched-off module do not appear.

## Openers

### Hero

A full-width opening section. Eyebrow, heading, body, up to two buttons, and a background image with overlay.

### Page header

A smaller opener for interior pages. Eyebrow, heading, body.

## Text

### Section heading

A heading with an optional standfirst, for breaking a page into sections.

### Text

Rich text — headings, paragraphs, lists, links, bold and italic.

### Buttons

One or more buttons in a row. Each has a label, a destination and a style. Destinations can be a page, picked from a list, or any URL.

### Tag row

A row of small pills. Useful for technologies, services or categories.

## Cards

### Card grid

Two to twelve cards, each with an optional image, badge, title, body, bullet list and link. Two, three or four columns.

### Portfolio grid

*Requires Portfolio.* Published projects as a grid. Pin it to one project type, or leave it open and offer the type filter. Choose columns, a maximum, and the wording when there is nothing to show.

### Feature panel

A panel of features with icons.

### Stat cards

Numbers with labels — clients served, projects delivered, years in business.

### Accordion

Collapsible questions and answers. Useful for FAQs.

## Media

### Image

One image with optional caption, width and rounding.

### Gallery

Several images in a grid, with layout and aspect-ratio options.

### Carousel

A slideshow. Every slide renders without JavaScript, so nothing disappears if scripts fail.

### Video

An embedded video from a URL.

### Map

A Google map. Shares the key from **Identity & Content**, overriding only the location and zoom. Renders nothing until a key and location exist.

## Layout

### Columns

Side-by-side areas you can drop any block into. Any ratio, resizable by dragging. Options: split, gap, vertical alignment, when to stack, and whether to keep a column in view as a sidebar.

### Spacer

Vertical space, where spacing settings are not enough.

### Divider

A horizontal rule — plain, glowing or dotted.

## Store

*All require the Store module; the review blocks require Reviews.*

### Store hero

An opening banner for the shop with a button into it.

### Shop listing

The whole catalogue with search, price filter, sorting and paging. This is what the shop page is built from. Options: columns, whether to offer filters, whether to show the category row, and the empty-state wording.

### Product grid

A selection of products — featured, newest, on sale, everything, or one category. Choose columns, how many, and a link underneath. Unlike Shop listing, it ignores search and filters, so it works as a teaser on any page.

### Featured product

One product given room to sell itself, with the image on either side.

### Product categories

Your categories as a row of cards, optionally with product counts.

### Store call to action

A band inviting visitors into the shop.

### Product reviews

*Requires Reviews.* Approved reviews for one product, with a rating breakdown and verified-purchase badges.

### Review showcase

*Requires Reviews.* Your best approved reviews, anywhere on the site. Filter by minimum rating.

### Discord community

*Requires Discord.* Your server with live member counts. Three layouts — compact card, sidebar widget, full-width band. Join button in your colours or Discord blurple.

## Conversion

### Call to action

A band with a heading, body and button.

### Contact form

*Requires Queries.* The public contact form. Submissions arrive in **Queries**.

## Advanced

### Custom HTML

Raw HTML for embeds a block does not cover.

{% hint style="danger" %}
Requires the `pages.embed_html` permission, which most roles should not hold. Content here is **not** sanitised — that is the point, and the risk. An existing HTML block survives editing by someone without the permission, but they cannot add or change one.
{% endhint %}


---

# 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://hollow-peak.gitbook.io/docs/page-builder/block-reference.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.
