---
title: "Blocks reference"
description: "Every litetile block, what it is for and the options it offers, with the options every block shares - Anchor, Vertical padding and Background."
url: "https://www.litetile.io/docs/blocks"
lang: "en"
---

This section helps you pick the right blocks (the sections of a page) and set their options.

Note

Every block is on every plan, except **Embed** and **Post list**, which are on Studio. On Free, a page publishes up to 10 blocks.

## What a block is

A page is a stack of blocks. Professional designers made each one to fit with the others, and your brand (colours, fonts, corners, buttons) decides how it looks. You add blocks from **Add blocks** in the editor's left rail, then fill in their words and images on the canvas or in the **Settings** panel on the right.

Each block's options sit in groups in the **Settings** panel, always in the same order: **Layout** first, then the block's content (**Heading**, **Buttons**, **Image** and its lists), and **Background** last.

![The editor's settings panel with a block's Layout and Background options.](https://media.litetile.app/media/6eee3550-99b4-4494-8fc5-d588d1e67e1e/47205098-f8ec-4dd4-a993-76451a1a233a.png)

## Which pages a block fits

Each page has a type: **Page**, **Blog home**, **Post**, **Docs home** or **Doc page**. **Add blocks** offers only the blocks that fit the page you are editing.

Which pages a block fits

- Blocks
- Fit these page types

- Text, Figure, Section, Spacer, Embed, Heading, Code block, Callout, Table, Tabs Every type, including Post and Doc page
- Every other block (heroes, cards, contact, calls to action and the rest) and Post list Page, Blog home and Docs home

## Options every block shares

### Anchor

**Anchor**, in **Layout**, names the block so a link can jump straight to it. Every block has it.

- Type a short name such as opening-hours. The published address of the block becomes your text made safe for a web address: accents removed, spaces and other signs turned into hyphens, lower case, at most 64 characters.
- Leave it empty and the block keeps an automatic name. Links still work; the address is just not readable.
- To link to a block, set a button's or a link's **Link to** to **A section of the page** and choose the block.

### Vertical padding

**Vertical padding**, in **Layout**, sets the room above and below the block's content. Blocks that draw their own room have it (not **Section** or **Spacer**).

Vertical padding

- Choice
- What it does

- Top and bottom The full room above and below. This is the default.
- Top only Room above, none below.
- Bottom only Room below, none above.
- None No room above or below, so the block touches its neighbours.

### Background

**Background**, in the **Background** group, colours the block behind its content. Most blocks have it; **Section**, **Text** and the docs blocks do not.

Background

- Choice
- What it shows
- Text on it

- Surface Your surface colour. The default on most blocks. Dark
- Muted Your background colour, a quiet change from Surface. Dark
- Primary Your primary colour. Light
- Secondary Your dark section colour. Light
- Ocean gradient, Dusk gradient A dark gradient. Light
- Mist gradient, Meadow gradient A light gradient. Dark
- Image or video The file you choose in the Image or video field below it, filling the block and darkened so the text stays readable. Light

Text and buttons switch between dark and light by themselves to stay readable on the background you choose.

A video background plays by itself once the page has loaded, only while it is in view, and never for visitors who have asked their device to reduce motion. Until it plays, its poster image shows. **Spacer** offers every choice except **Image or video**.

### Heading and buttons

Most blocks open with the same heading group, in **Heading**:

Heading and buttons

- Option
- What it does

- Eyebrow A short line above the title, up to 40 characters. Optional.
- Title The block's headline, up to 80 characters.
- Subtitle One supporting sentence under the title, up to 160 characters. Optional.

Blocks with **Buttons** use the same button fields: **Label** (up to 32 characters), **Link**, **Style** (**Primary**, **Secondary**, **Dark**, **White**, **Outline**, **Light outline**, **Ghost**), **Icon** and **Icon position** (**After the label**, **Before the label**). **Link to** offers **A page**, **A section of the page**, **A phone number**, **An email address** and **A web address**, with **Open in a new tab**.

### Hiding a block

Turn a block's **Visibility** off to keep it on the page without publishing it. It shows a **Hidden** badge in the editor. See [Add, move and hide blocks](https://www.litetile.io/docs/editor/blocks).

## Block families

Block families

- Family
- Blocks

- Heroes Split hero, Cover hero, Collage hero, Gallery hero, Mosaic hero
- Features Feature list, Feature cards
- Photo cards Photo cards
- Steps Steps
- FAQ FAQ cards
- Plans and tables Plan cards, Comparison table
- Figures and numbers Figure, Stats row
- Contact Contact band, Contact details, Contact split
- Calls to action CTA band, CTA pair, CTA split
- Layout Section, Spacer
- Embed Embed (Studio)
- Blog and docs blocks Post list (Studio), Heading, Code block, Callout, Table, Tabs

Tip

Images are cropped to fill the shape each block gives them. Keep the subject of a photo near its centre, and use **Figure** when a picture must keep its own proportions.
