> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/customise-your-site/manage-your-pages/page-builder-blocks.md).

# Page Builder Blocks

A complete reference for every block in the page builder. What each block does, every option you will see when you edit it, and which pages it can be used on.

Every page on your site (your homepage, your About page, and any custom pages you create) is built from **blocks**. A block is one section of the page, such as a slider, a grid of competitions, or a newsletter sign up box. You stack blocks on top of each other to build the page.

This page lists every block you can choose from the **Add to blocks** picker, using the exact names you will see in your admin panel. For each one you will find what it does, every option it has, and tips on when to use it.

{% hint style="info" %}
New to the page builder? Start with [Set Up Your Homepage](https://docs.rafflex.io/customise-your-site/set-up-your-homepage.md), which walks you through opening the editor, adding blocks, moving them around and saving. Come back here when you want the detail on a particular block.
{% endhint %}

***

### Blocks at a glance

Most blocks can be used on any page. A few only appear in the **Add to blocks** picker when the page has a particular **Layout** (the Layout is chosen in the right hand sidebar of the page editor). Your homepage already uses the Home layout, so everything marked "Home layout" is available there.

| Block name in the picker     | What it shows                                                    | Where you can use it |
| ---------------------------- | ---------------------------------------------------------------- | -------------------- |
| **Sliders**                  | A rotating banner of the competitions you have chosen to feature | Any page             |
| **Product grid**             | A grid of all your live competitions, split by category          | Any page             |
| **Product horizontal grid**  | A side scrolling row of competitions                             | Any page             |
| **Stats one**                | Two stats you type yourself plus a countdown to the next close   | Home layout only     |
| **Mobile stats**             | Two small text badges shown on phones only                       | Home layout only     |
| **Instant Winners Carousel** | A scrolling row of your most recent instant winners              | Home layout only     |
| **Instant Winners Counter**  | A badge showing how many instant winners there have been today   | Any page             |
| **Winners display**          | Photos of your winners that you upload                           | Any page             |
| **Newsletter**               | An email sign up box                                             | Any page             |
| **Social links**             | Buttons or icons linking to your social media pages              | Any page             |
| **Video**                    | A YouTube video                                                  | Any page             |
| **Big picture content**      | A large image with a heading, text and a button                  | Any page             |
| **Call to action one**       | A heading, text and a button to drive a key action               | Any page             |
| **Gallery**                  | A collection of images                                           | Any page             |
| **Wysiwyg**                  | Formatted text, typed in a simple editor                         | Any page             |
| **Adv Code**                 | Your own HTML code                                               | Any page             |
| **Custom Twig Block**        | A fully custom section you design with Twig                      | Any page             |
| **About layout**             | Your About page introduction, story and stats                    | About layout only    |

{% hint style="warning" %}
**One Gallery, one Winners display and one Big picture content per page.** The images you upload to these blocks (and the **Featured Image** on a Big Slider) are saved against the page, not against the individual block. If you add two Gallery blocks to the same page, both will show the same set of images. Use one of each per page. If you need a second set of images, put it on a different page.
{% endhint %}

***

### Competition blocks

These blocks fill themselves with your competitions automatically. A competition only appears in them while it is live and publicly listed: switched to **Active**, past its start date, before its end date, not sold out, and not set as a **Hidden / VIP Competition**. If one is missing, see [Why a Competition Is Not on My Homepage](https://docs.rafflex.io/customise-your-site/set-up-your-homepage/why-a-competition-is-not-on-my-homepage.md).

#### Sliders

A large rotating banner, usually placed at the very top of the homepage. It shows the competitions you have switched **Add To Slider** on for. You do not pick competitions inside the block itself. See [How the Sliders Block Chooses Competitions](https://docs.rafflex.io/customise-your-site/set-up-your-homepage/how-the-slider-chooses-competitions.md) for the full detail.

| Option               | What it does                                                                                                                                                                                       |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Slider Style**     | Chooses the look and animation of the slider. A short description of each style appears under the dropdown once you choose one.                                                                    |
| **Collection Order** | The running order of the slides: **Default Order**, **Sort Order** or **Random Order**. Not shown for the Custom Twig (Advanced) style.                                                            |
| **Featured Image**   | Big Slider and Custom Twig (Advanced) only. Your own banner image (JPG or PNG, up to 800KB). On the Big Slider it becomes the first slide, before your competitions.                               |
| **Content**          | Big Slider and Custom Twig (Advanced) only. Four short text fields: **Title**, **Value**, **Subtitle** and **Subvalue**. On the Big Slider these appear in the bar along the bottom of the slider. |
| **Slides Mode**      | Spring Slider only. **Single Slide** or **Multiple Slides (Cascading Effect)**.                                                                                                                    |

The **Slider Style** options are:

| Style                      | What it looks like                                                                                                                                 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Big Slider**             | Full width hero slider with large images. The only built-in style that also supports your own Featured Image and text bar.                         |
| **Expo Slider**            | A clean, exhibition style layout with smooth transitions and subtle animation.                                                                     |
| **Three Slider**           | Three competitions side by side, with the centre one emphasised and the neighbours scaled down.                                                    |
| **Coverflow Slider**       | A 3D coverflow effect where slides rotate and scale as they move.                                                                                  |
| **Material Slider**        | A minimal design with soft shadows and smooth transitions.                                                                                         |
| **Eagle Slider**           | Bold, dramatic transitions with a strong visual presence.                                                                                          |
| **Super Flow Slider**      | A fluid, continuous flow with overlapping slides cascading into view.                                                                              |
| **Shaders Slider**         | Eye catching animated transition effects such as ripples and morphs.                                                                               |
| **Spring Slider**          | Springy, bouncy animations with a ticket sales progress bar. Choose single or multiple slides.                                                     |
| **3d Slider**              | A true 3D carousel where slides rotate around a central point.                                                                                     |
| **Custom Twig (Advanced)** | Build your own slider design with HTML and Twig. See [Custom Twig Slider](https://docs.rafflex.io/advanced/twig-templating/custom-twig-slider.md). |

{% hint style="info" %}
Slides use each competition's **Slider Image**. If a competition does not have one, its main Featured Image is used instead, which can look stretched or cropped. For the recommended sizes, see the [Image Size Guide](https://docs.rafflex.io/customise-your-site/add-your-logo/image-size-guide.md).
{% endhint %}

#### Product grid

The main grid of competitions. Every live, publicly listed competition appears here, so this is the block most sites rely on to show their full range.

| Option                      | What it does                                                                                                                                                      |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Segmenting Competitions** | How the grid is split up. **All + Filter** or **Calendar + Categories** (explained below).                                                                        |
| **Competition Card Style**  | The design of each competition card: **Flint**, **Onyx**, **Obsidian**, **Ember**, **Simple**, **Neon**, **Brutalist**, **Zenith** or **Custom Twig (Advanced)**. |
| **Competition Sorting**     | **Ending Soonest at the top.** or **Manual Sort Order**.                                                                                                          |

**Segmenting Competitions** gives you two ways to organise the grid:

* **All + Filter** shows one grid with a row of tabs above it. The tabs are **All**, then **Today** (only when at least one competition ends today), then one tab for each of your [product categories](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/product-categories.md) that currently has a live competition in it. Customers click a tab to filter the grid.
* **Calendar + Categories** shows everything at once in stacked sections. First a **Today** section for competitions ending today, then a section for each category, headed with the category name and its description. There is no "All" section in this style.

{% hint style="warning" %}
With **Calendar + Categories**, a competition that has no category is only shown on the day it ends (in the Today section). If you use this style, make sure every competition has at least one category. A competition in more than one category appears in each of those sections.
{% endhint %}

**Competition Sorting** controls the order of the cards:

* **Ending Soonest at the top.** puts the competition closing next first. This is a good default because it creates urgency.
* **Manual Sort Order** uses the order you set yourself. To set it, open **Competitions** in the admin panel, click **Enable reordering**, drag the competitions into the order you want, then click **Finish**.

When you use one of the built-in card styles, sorting applies to the All tab and the category tabs. The Today list always follows your manual sort order, and in Calendar + Categories each category section lists its competitions ending soonest first.

If you choose **Custom Twig (Advanced)** as the card style, a **Custom Card Template** panel appears with a **CSS Styles (loaded once)** editor and a **Card HTML + Twig Code** editor, so you can design your own cards. See [Custom Twig Product Grid](https://docs.rafflex.io/advanced/twig-templating/custom-twig-product-grid.md).

{% hint style="success" %}
Not sure which card style to pick? Add the block, choose a style, save, and look at your live site. Swap styles and save again until you find the one that suits your brand. Nothing else changes when you switch.
{% endhint %}

A few things depend on the card style you choose:

* **Quick add buttons**, so customers can add tickets without opening the competition, are on the **Onyx**, **Ember** and **Zenith** styles. The number of tickets they start on is suggested from the ticket price, not taken from the competition's own ticket options.
* **A live countdown** to the closing time is on the **Onyx**, **Ember**, **Obsidian**, **Neon** and **Brutalist** styles.
* **The competition Subtitle** is shown on the **Ember**, **Neon** and **Obsidian** styles.
* **Your Custom Icon** sits on the progress bar of the **Obsidian** and **Neon** styles. See [Add Your Logo](https://docs.rafflex.io/customise-your-site/add-your-logo.md).

Where the date, price and badges sit on a card is part of its design, and so is the number of cards per row (three across on larger screens, two on phones). These cannot be moved or changed. If no style suits you, choose **Custom Twig (Advanced)** and design your own cards.

#### Product horizontal grid

A single row of competitions that customers scroll through sideways using arrow buttons, a bit like a streaming service. It shows up to six cards across on a large screen and fewer on smaller screens. It works well for a themed row such as "Cash Prizes" or "Ending This Week" further down the page.

| Option                     | What it does                                                                                                         |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Title**                  | The heading shown above the row. Required.                                                                           |
| **Competition Card Style** | **Movie Card** is the only style. It uses each competition's **Portrait Image**, falling back to the Featured Image. |
| **Filter Categories**      | Choose one or more categories to show only those competitions. Leave it empty to show every live competition.        |

{% hint style="info" %}
Movie Cards are tall, so upload a portrait image (600px by 800px is recommended) to each competition for the best look. See the [Image Size Guide](https://docs.rafflex.io/customise-your-site/add-your-logo/image-size-guide.md).
{% endhint %}

***

### Stats and winners blocks

#### Stats one

A wide strip with two stats on the left and a **Next Competition:** countdown on the right. Available on pages using the Home layout.

| Option                        | What it does                                                                                                                      |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Value** and **Title**       | Your first stat. The Value is shown large (for example "1,200+") with the Title as a smaller label (for example "Total Winners"). |
| **Subvalue** and **Subtitle** | Your second stat, shown the same way (for example "£250k+" and "Paid Out").                                                       |

* Both stats are plain text that you type. They never update on their own, so remember to refresh them from time to time.
* If you leave a field empty, the block shows "tbc" in its place.
* The countdown picks its own target: the live, publicly listed competition that closes soonest. You cannot choose it.
* On phones, the two stats are hidden and only the countdown shows. Pair this block with **Mobile stats** if you want stats on phones too.

{% hint style="info" %}
For the full story on how the countdown chooses a competition, see [Stats Block Countdown Explained](https://docs.rafflex.io/customise-your-site/set-up-your-homepage/stats-block-countdown-explained.md).
{% endhint %}

#### Mobile stats

Two small coloured badges, side by side, that only appear on phones. They are hidden on tablets and computers. Available on pages using the Home layout.

| Option    | What it does                                                 |
| --------- | ------------------------------------------------------------ |
| **Left**  | The text for the left badge, for example "1,200+ Winners".   |
| **Right** | The text for the right badge, for example "£250k+ Paid Out". |

Both badges are plain text you type yourself. This block has no countdown. A common set up is to place **Mobile stats** directly above or below **Stats one**, so phone visitors still see your headline numbers.

#### Instant Winners Carousel

A scrolling row of your 20 most recent instant winners, which keeps itself up to date as people win. It is great social proof because customers can see real wins happening. Available on pages using the Home layout.

| Option                           | What it does                                                                                                                                |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Header Position**              | Where the header sits: **Above Carousel**, **Below Carousel**, **Left of Carousel**, **Right of Carousel** or **No Header**.                |
| **Instant Winners Layout Style** | The design of the winner cards: **Default**, **Obsidian**, **Rounded**, **Brutalist**, **Neon**, **Gradient**, **Transparent** or **Glow**. |
| **Show Winners Location**        | On by default. "This will display the winners town if available."                                                                           |

* Each card shows the prize, "Won by" with the winner's display name, and how long ago they won. With **Show Winners Location** on, the winner's town is added when they have one on their account.
* The header shows a count of today's instant winners above the words **Recent Instant Winners**. The header is hidden on phones.
* Wins from hidden (VIP) competitions, and from competitions that have not started yet, are never shown.
* New wins are picked up automatically, usually within a minute or so. Visitors see them the next time the page loads. There is nothing for you to update.

{% hint style="warning" %}
When you first add this block, the **Instant Winners Layout Style** dropdown can look empty. Always pick a style from the list (choose **Default** if you are unsure) before you save, then check your live homepage.
{% endhint %}

#### Instant Winners Counter

A single eye catching badge showing how many instant wins there have been today. The count starts again from zero at midnight. You can use it on any page.

| Option           | What it does                                                                                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Layout Style** | **Version 1: Badge-style Card**, **Version 2: Icon Box with Gradient Glow**, **Version 3: Stat Box with Vertical Divider**, **Version 4: Circle Count Widget**, **Version 5: Full Banner with Glow Border** or **Custom Twig (Advanced)**. |

The count keeps itself up to date, but it is only refreshed every few minutes, so a brand new win can take a short while to be counted. To learn more about instant wins themselves, see [Managing Instant Winners](https://docs.rafflex.io/drawing-winners/managing-instant-winners.md).

#### Winners display

A showcase of photos of your winners, with a heading, a short description and a link to your results page.

| Option                     | What it does                                                                    |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Title**                  | The heading. Required (except with Custom Twig).                                |
| **Description**            | A short line of text under the heading. Required (except with Custom Twig).     |
| **Winners Display Layout** | **Default**, **Grid**, **Carousel**, **Minimal** or **Custom Twig (Advanced)**. |
| **Gallery**                | Upload up to 6 winner photos (JPG or PNG). Drag them to change the order.       |

There is no box for each winner's name or prize, and some layouts add a fixed label under each photo (such as **Winner #1**) that you cannot edit. To show a name and prize, put them into the photo itself before you upload it, or choose **Custom Twig (Advanced)** to design your own layout.

Every built-in layout links customers to your results page. **Default** and **Grid** show a **See all winners** link, **Carousel** shows a **View All Winners** button, and **Minimal** shows a **View all results** link.

{% hint style="warning" %}
**This block does not update automatically.** It only ever shows the photos you upload. When you have new winners, come back and swap the photos in. If you want something that keeps itself up to date, use the **Instant Winners Carousel** or the **Instant Winners Counter**.
{% endhint %}

***

### Engagement blocks

#### Newsletter

An email sign up box that invites visitors to join your mailing list. The heading and wording are built into each style, so there is no text for you to edit. You choose the look:

| Option                      | What it does                                                                                        |
| --------------------------- | --------------------------------------------------------------------------------------------------- |
| **Newsletter Layout Style** | **Default**, **Minimal**, **Bold**, **Centered**, **Split**, **Inline**, **Bento** or **Floating**. |

When a visitor enters their email address and submits it, they see a "Thank you for subscribing to our newsletter!" message.

{% hint style="danger" %}
**Connect your email marketing first.** Sign ups are only passed on when you have an email marketing service connected. Without one, visitors still see the thank you message, but their email address is not saved anywhere. See [Set Up Email Marketing](https://docs.rafflex.io/marketing/sms-and-email/set-up-email-marketing.md) or the [Klaviyo Integration](https://docs.rafflex.io/marketing/sms-and-email/klaviyo-integration.md).
{% endhint %}

#### Social links

A row of buttons or icons linking to your social media pages.

| Option                                                      | What it does                                                                                                    |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Title**                                                   | An optional heading above the links (up to 60 characters).                                                      |
| **Layout Style**                                            | **Social Buttons** (coloured, labelled buttons), **Social Icons** (simple icons) or **Custom Twig (Advanced)**. |
| **Facebook**, **Instagram**, **X**, **Youtube**, **Tiktok** | The full web address of each profile, starting with `https://`.                                                 |

Only the networks you fill in are shown, and each link opens in a new tab.

{% hint style="info" %}
This block uses its own links. It does not read the social links in your site Settings (the ones covered in [Connect Your Social Accounts](https://docs.rafflex.io/additional-settings/settings/connect-your-social-accounts.md)), so fill the addresses in here too.
{% endhint %}

#### Video

Shows a YouTube video on the page, sized to fit the width of the content area.

| Option               | What it does                                           |
| -------------------- | ------------------------------------------------------ |
| **Youtube video id** | The ID of the video only, not the full link. Required. |

The ID is the short code at the end of the video's link. For example:

* `https://youtu.be/h2kj3h43jk` has the ID `h2kj3h43jk`
* `https://www.youtube.com/watch?v=h2kj3h43jk` has the ID `h2kj3h43jk` (the part after `v=`)

{% hint style="warning" %}
If the video area shows an error, check you have pasted only the ID. Pasting the whole link is the most common mistake.
{% endhint %}

#### Big picture content

A large image with a heading, a paragraph and a button laid over it. Ideal for introducing your brand or promoting one key message.

| Option          | What it does                                                                                             |
| --------------- | -------------------------------------------------------------------------------------------------------- |
| **Title**       | The heading. Required (except with Custom Twig).                                                         |
| **Description** | The paragraph of text. Required (except with Custom Twig).                                               |
| **Button text** | The words on the button, for example "Enter Now". Required (except with Custom Twig).                    |
| **Button url**  | Where the button goes, for example `/results` or a full web address. Required (except with Custom Twig). |
| **Image**       | The background image (JPG or PNG, up to 800KB).                                                          |
| **Layout**      | **Default** or **Custom Twig (Advanced)**.                                                               |

#### Call to action one

A focused section with a heading, some text and a button, designed to push visitors towards one action such as entering a competition or visiting your results.

| Option          | What it does                                                                                                                            |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**       | The heading. Required (except with Custom Twig).                                                                                        |
| **Description** | The supporting text. Required (except with Custom Twig).                                                                                |
| **Button text** | The words on the button. Required (except with Custom Twig).                                                                            |
| **Button url**  | Where the button goes. Required (except with Custom Twig).                                                                              |
| **CTA Layout**  | **Default**, **Hero Banner**, **Split Layout**, **Action Banner**, **Centered Card**, **Gradient Focus** or **Custom Twig (Advanced)**. |

Each built-in layout also adds a small secondary link next to your button. On most layouts it points to your About page (for example "Learn more about us"). On **Gradient Focus** it invites visitors to get in touch through your Contact page.

#### Gallery

A collection of images with a heading and description.

| Option          | What it does                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------- |
| **Title**       | The heading. Required (except with Custom Twig).                                                           |
| **Description** | A line of text under the heading. Required (except with Custom Twig).                                      |
| **Layout**      | **Grid** (neat, even rows), **Masonry** (a staggered, Pinterest style wall) or **Custom Twig (Advanced)**. |
| **Gallery**     | Upload up to 32 images (JPG or PNG, up to 512KB each). Drag them to change the order.                      |

{% hint style="info" %}
Keep gallery images the same size and shape for a tidy Grid. Masonry copes better with a mix of shapes.
{% endhint %}

***

### Text and code blocks

#### Wysiwyg

A simple text editor ("what you see is what you get") for adding formatted text to any page. The toolbar lets you add bold and italic text, links, two heading sizes, bulleted and numbered lists, and quotes, with undo and redo. This is the block used on your Terms & Conditions and Privacy Policy pages.

#### Adv Code

A code box for pasting your own HTML, for example an embed code from a reviews widget or a booking tool. Whatever you paste is placed on the page exactly as it is.

{% hint style="warning" %}

* Twig does not work in this block. If you want dynamic content, use the **Custom Twig Block** instead.
* Broken or incomplete code can upset the layout of the rest of the page. Only paste code from sources you trust, and check your live site straight after saving.
  {% endhint %}

#### Custom Twig Block

The most flexible block in the builder. You create your own variables (text, images, competitions, recent winners and more) and write an HTML and Twig template to display them however you like. This is aimed at confident users or developers.

{% content-ref url="/pages/0sIXHlxMUQHe7yheXOco" %}
[Custom Twig Block](https://docs.rafflex.io/advanced/twig-templating/custom-twig-block.md)
{% endcontent-ref %}

***

### About page block

#### About layout

The main section of your About page. It only appears in the picker when the page's **Layout** is set to About, and you can add it only once per page.

| Option          | What it does                                                                                                                                                                                     |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Pre title**   | A short line shown above the heading, for example "Here We Go!".                                                                                                                                 |
| **Title**       | The main heading, for example "About Us".                                                                                                                                                        |
| **After title** | A sentence shown under the heading.                                                                                                                                                              |
| **About**       | Your story, written in a text editor with the same formatting tools as the Wysiwyg block.                                                                                                        |
| **Stats**       | A list of highlight figures. Each one has a **Stat title** (the label) and **Stat data** (the figure, for example "£1+ Million"). Three are added to start with, and you can add or remove them. |

***

### Blocks with a Custom Twig (Advanced) option

Several blocks let you swap their built-in design for your own template by choosing **Custom Twig (Advanced)** as their style or layout: **Sliders**, **Product grid**, **Instant Winners Counter**, **Winners display**, **Social links**, **Big picture content**, **Call to action one** and **Gallery**. When you choose it, a collapsed **Custom Twig Code** panel (on the Product grid, **Custom Card Template**) appears. Click it to open the code editor.

These options are designed for people comfortable with HTML. If that is not you, the built-in styles cover most needs and look great out of the box.

{% content-ref url="/pages/xrxmyPoTkuZZCTsHIcdQ" %}
[Twig Templating](https://docs.rafflex.io/advanced/twig-templating.md)
{% endcontent-ref %}
