Boardwalk Block Guide

Scroll Reveal Group

Everything you need to set up and customize the Scroll Reveal Group — a layout block that reveals its content with a smooth animation as visitors scroll down the page.

About

A scroll reveal is a visual effect where content gradually appears as a visitor scrolls down the page. Instead of all your text and buttons being visible the moment the page loads, they smoothly animate into view when the visitor reaches that part of the page. This creates a more engaging, polished browsing experience that draws attention to your content at just the right moment.

In the Boardwalk theme, the Scroll Reveal Group is a layout block that wraps text and button blocks inside a scroll-triggered animation container. When a visitor scrolls to the group, its contents are gradually revealed with a smooth transition effect. The group supports both horizontal and vertical layouts, and gives you full control over alignment, spacing, and maximum width.


How to Set Up a Scroll Reveal Group

Follow these steps to add and configure a Scroll Reveal Group on any page of your Shopify store using the Boardwalk theme.

1
Open the Theme Editor

In your Shopify admin, go to Online Store → Themes, find Boardwalk, and click Customize. Navigate to the page where you want to add the scroll reveal effect using the page selector dropdown at the top center of the editor.

2
Add a Scroll Reveal Group

Inside any section that supports blocks, click Add block in the Theme Editor sidebar and choose Scroll reveal group from the list. The group will appear in the sidebar as a collapsible container where you can add content blocks inside it.

3
Add Content Blocks

Click into the Scroll Reveal Group and add Text and/or Button blocks inside it. These are the content elements that will animate into view when a visitor scrolls to this area. You can add multiple text and button blocks and reorder them as needed.

4
Configure the Group Settings

Click on the Scroll reveal group block in the sidebar to access its settings. Set the layout direction, maximum width, alignment options, and padding to control how the content is arranged and spaced.

5
Save and Preview

Click Save in the Theme Editor. Preview your page and scroll down to verify that the text and buttons reveal smoothly as you reach the group's position on the page.

Note: The scroll reveal animation is best viewed on the live storefront or in the Theme Editor preview. The effect may not play inside the Theme Editor's sidebar preview panel.


Supported Blocks

The Scroll Reveal Group acts as a container for other blocks. You can add the following block types inside a Scroll Reveal Group.

Text

A rich text block for headings, paragraphs, or any written content. Use this for headlines, descriptions, or any message you want to reveal as the visitor scrolls.

Button

A clickable button block that links to any page, product, collection, or external URL. Pair buttons with text blocks to create call-to-action areas that animate into view as visitors scroll.


Group Settings

These settings control the layout, alignment, and spacing of the Scroll Reveal Group. Access them by clicking the group block in the Theme Editor sidebar.

Layout & Content

Layout direction

Controls how the blocks inside the group are arranged. Horizontal places blocks side by side in a row. Vertical stacks them on top of each other.

Content maximum width

Limits the width of the group's content. Auto lets the content fill the available space. Narrow constrains the content to a maximum of 600px, which is useful for centering text in wider layouts.

Alignment

Text alignment

Sets the text alignment for all content inside the group. Options: Left, Center, or Right.

Horizontal alignment

Controls how blocks are positioned along the horizontal axis. Options: Left, Center, Right, or Space between. Use Space between to spread blocks evenly across the available width.

Vertical alignment

Controls how blocks are positioned along the vertical axis. Options: Top, Middle, Bottom, or Space between. This is especially useful in horizontal layouts where blocks may have different heights.

Desktop Padding

Gap

Controls the spacing between each block inside the group on desktop screens. Range: 0px to 100px.

Horizontal padding

Adds horizontal (left and right) padding around the group's content on desktop. Range: 0px to 200px.

Vertical padding

Adds vertical (top and bottom) padding around the group's content on desktop. Range: 0px to 200px.

Mobile Padding

Gap

Controls the spacing between each block inside the group on mobile devices. Range: 0px to 100px.

Horizontal padding

Adds horizontal (left and right) padding around the group's content on mobile. Range: 0px to 200px.

Vertical padding

Adds vertical (top and bottom) padding around the group's content on mobile. Range: 0px to 200px.


Built-In Features

The Scroll Reveal Group comes with features that work automatically — no apps or custom code needed.

Feature Overview

Scroll-triggered text reveal

Content inside the group stays hidden until the visitor scrolls to its position on the page. Once in view, text and buttons animate in with a smooth reveal effect, creating a dynamic and engaging reading experience.

Flexible layout directions

Arrange your content horizontally (side by side) or vertically (stacked). This makes the group versatile enough for headline-and-button combos, multi-line content areas, or inline call-to-action layouts.

Separate desktop and mobile spacing

The group has independent padding and gap settings for desktop and mobile, letting you fine-tune the spacing for each screen size without affecting the other.

Narrow width option

The content maximum width setting lets you constrain text to a narrower column (600px). This is useful for centering a headline and paragraph on a wide section without having text stretch across the full width.

Reduced motion support

If a visitor has enabled the "reduce motion" setting in their operating system or browser, the scroll reveal animation is automatically simplified or disabled. This ensures the experience remains comfortable and accessible for everyone.


Frequently Asked Questions

No. The Scroll Reveal Group currently supports only Text and Button blocks. If you need an image with a scroll reveal effect, consider placing the image in a separate block alongside the group, or using a section that has its own built-in scroll animations.
There are a few things to check. First, make sure you are previewing the live storefront or using the Theme Editor's full-page preview — the animation may not play inside the sidebar editing panel. Second, check if your browser or operating system has "reduce motion" enabled, as this will simplify or disable the animation. Finally, make sure the group is placed far enough down the page that scrolling is required to reach it — if it's already visible when the page loads, the animation may complete instantly.
A regular group displays its content immediately when the page loads. A Scroll Reveal Group adds a scroll-triggered animation that gradually reveals the content as the visitor scrolls to it. Both share the same layout and spacing settings, but the Scroll Reveal Group adds the animated reveal effect on top.
Yes. You can add as many Scroll Reveal Groups as you like across different sections on the same page. Each group will animate independently as the visitor scrolls to its position.
No. The scroll reveal animation is lightweight and optimized for performance. It uses the browser's built-in scroll observation to trigger the effect efficiently, so it won't slow down your page or affect loading times.