# Shared blocks Most sections have blocks made for them, such as a slide in **Slideshow** or a question in **FAQ**. Those are listed on each [section's page](page:sections). Over thirty blocks are shared: the same block, with the same settings, wherever it's allowed. **Rich text**, **Image with text** and **Group** take all of them, and a Group can hold another Group. Other places take the ones that fit them, such as a text cell in **Layout grid**, a slide, the footer or the product page; each block below lists where. That way you can build a card, a row of buttons or a small FAQ without a new section. ## Add a block 1. In the editor's list, under a section that takes shared blocks, select **Add block**. 2. Pick a block. Some blocks come in more than one version, such as **Group** and **Button row**. 3. Drag the block by its handle to move it, or select it and use **⋯** to duplicate, hide or remove it. To put blocks inside a Group, select **Add block** under that Group. - A section holds up to 50 blocks. - Groups can sit inside groups, up to eight levels deep. - Some blocks are fixed: you can't remove or move them, only edit or hide them. The product card inside **Featured collection** is one: set it up once and every card follows. ## What to build with them - **Card**: a **Group** with **Padding**, **Show border** or **Own color scheme**, holding a Heading, Text and Button. - **Two buttons side by side**: the **Button row** version of Group. - **Short FAQ**: a few **Collapsible row** blocks one after another. - **List of promises**: a Group set to **Row**, holding **Icon** blocks; give an icon a link or your own image. - **Numbers that matter**: a Group set to **Row** with **Counter** blocks, which count up when they come into view. - **A launch date**: a **Countdown** to a real date and time, with a message for after it. - **A quiet break**: a **Divider** line between two groups of blocks. - **Show the difference**: **Before and after** puts two photos of the same view under a handle shoppers slide. - **Photo with a newsletter**: the **Layout grid: photo and newsletter** preset of [Layout grid](section:layout-grid), or an **Email signup** inside a Group. ## Spacing and visibility Every shared block ends with the same four settings, so a heading, a button or an image moves the same way: - **Space above** and **Space below**: extra room before and after the block, in pixels. 0 keeps the space the section already gives it. - **Space kept on phones**: the share of that extra room kept on small screens, for example 50% to halve it. - **Show on**: **All devices**, **Desktop only** (screens 990px and wider) or **Mobile and tablet only**. Show a short button label on phones and a longer one on computers, or a different image for each. In the theme editor a hidden block stays visible but faded, so you can still select and edit it. ## Width and animation Text, heading, button, image, video, email signup, group, image comparison, countdown and collapsible blocks also have **Width**: **The block's own** keeps its design, **Fill the row** stretches it across, and **Custom width** sets a share of the row, with its own share on phones, for example a text half as wide as the section on computers and full width on phones. Every shared block has **Animation → Entrance**: fade in, fade up, fade down, or slide in from the start or end, with a **Delay** of up to two seconds so blocks can follow one another. It plays once, when the block scrolls into view; selecting the block in the theme editor plays it again. Nothing moves when **Theme settings → Motion** is off or the visitor's device asks for reduced motion. ## Corners and boxes Image, video and image comparison blocks have **Corners**: **Follow Corner style** from Theme settings → Layout, **Square**, or **Custom** with your own radius. Text and heading blocks can sit in a **Box**: pick a **Background** and, if you like, a **Text color** and **Padding**; the box follows the same corner choices. Leave the background empty for no box. ## Button icons The **Button** block's **Icon** is **Auto** (an arrow on buttons, none on a text link), none, or one of the theme's icons, such as a bag, search or mail. **Icon position** puts it after or before the label, and **Icon only** makes a square button with just the icon, while screen readers still read the label. **Full width on phones** stretches the button on small screens only. ## Image shapes The **Image** block's **Image shape** crops to square, portrait (4:5), tall (3:4), landscape, wide (16:9) or extra wide (21:9), or makes a **Circle** or an **Oval**; **Adapt** keeps the photo's own shape. **Shape on phones** can crop differently on small screens, **Height → Fill** stretches the image to the height of its row inside a group, and **Border** draws a line round it in the color you pick. ## Badges on an image Add **Badge** blocks inside an **Image** block to put short shaped labels on the photo, or start from the **Image with badges** preset. Each badge has: - a **Shape**: Tag, Petal star, Star, Circle, Scalloped circle, or an image of your own; - a **Small line** and a **Text** with its size, and its **Background** and **Text color** (empty: the color scheme reversed); - **Rotate**, and a **Loop animation** that floats it up or down (still when Motion is off); - a **Position**: where its center sits on the image, from the left and from the top. Below 0 or above 100 lets it hang past the edge. **Other position on phones** and **Hide on phones** help on small screens; - a **Width**, with its own width on phones. ## Video options The **Video** block can loop or play once when it plays by itself, hide the **Player controls** so the video works as a moving picture, and take a **Description** that screen readers read out. **Image shape** adds 21:9 for wide, cinematic clips. With a **Cover image** (and Autoplay off), **Play button** sets how the button on the cover looks: **White circle**, **Outline**, **Large circle**, or **With its label**, a pill that shows the **Play button label** (empty: Play video). ## Divider, spacer and email signup The **Divider** block's line can be full width, short or a **Length** in percent, with its own **Thickness**, **Line style** (solid, dashed or dotted) and **Color**. The **Spacer** goes up to 400px on computers and 300px on phones. The **Email signup** block can be centered, and its **Note** takes links, for example to your privacy policy. ## Icon options The **Icon** block offers 40 icons, from delivery and returns to weather and the pocket icons, or your own image (**Round image** cuts it to a circle). **Icon size** goes up to 200px with its own **Icon size on phones**, **Icon style** can put the icon in a tinted circle, **Text position** sets the text beside or under it, and a linked icon can open in a new tab. ## Counter options The **Counter** block counts up from a **Start number** over its **Duration**. **Style** shows it plain, on a tinted **Card**, or in a **Circle** whose ring fills as the number counts. **Text position** puts the label under, above or beside the number, **Alignment** sets it left, centered or right, and a **Gradient** colors the digits. ## Countdown options The **Countdown** block counts down to the date you enter, or, with **End date → The product's date**, to the product's own date from its `custom.countdown_end` metafield on a product page (see [Metafields](page:metafields)). **Style** shows the units in boxes, as plain numbers or large; **Show the unit names** can hide the days, hours, minutes and seconds labels, and **Alignment** places it. It only counts to real dates: with no date, or once it has passed, it shows your **After** text or nothing. ## Before and after The **Before and after** block slides between two photos side by side or, with **Direction → Top and bottom**, with a line that moves up and down. **Shape on phones** can crop it differently on small screens. The handle works with a keyboard and screen readers in both directions. ## Group options The **Group** block holds other blocks in a column, a row or a grid. Besides gap, alignment, padding, border and color scheme it has: - **Direction → Grid** for equal columns: **Columns on computers** (1–6, at most 3 on tablets) and **Columns on phones** (1–3), or **Swipe on phones**. - **Gap → Custom** in pixels, **Vertical position** (start, center, end or stretch) and **Keep on one line** for rows. - **Height → Fill** to match a taller neighbour, and **Stay in view while scrolling** on computers, for example a description beside a long column of photos. - **Reverse order on phones** and **Swipe on phones**, which turns a row or a grid into one line of cards that scrolls sideways, with **Card width on phones**. - **Link for the whole group**, with a **Link name** for screen readers; buttons and links inside keep their own. - **Background image** with an **Overlay opacity**. ## Image card The **Image card** block is a photo with content made of blocks, such as a heading, a text, a button, a countdown or a label. **Content** puts them below the image or on it, at the bottom, center or top, over an **Overlay** whose opacity you set; pick a **Color scheme** whose text reads on the photo. **Link for the whole card** makes the card one link while its own buttons keep theirs, and **Zoom the image on hover** gives it a slow zoom. In a row group, several cards share the row and wrap on small screens. ## Label, discount code and Custom Liquid - **Label**: a word or two as a pill, an outline or plain small capitals, with an optional dot, star or check and your own colors, for example *New season* above a heading. - **Discount code**: a code you created in **Shopify admin → Discounts**, with a copy button. The theme shows exactly what you enter, so keep it to codes that work. - **Custom Liquid**: your own Liquid or HTML wherever you place the block, for example an app's snippet. ## Icon list The **Icon list** block holds short **Lines**, each with an icon, a text and an optional link, for example your delivery and returns promises. Lay them out in a column or a row, set the **Gap** and **Icon size**, put the icons in tinted circles, and add **Lines between items**. ## Spinning badge The **Spinning badge** block runs a short text round a circle with an icon in the middle, and turns slowly; set its **Size**, **Time per turn** and colors, and give it a link. End the text with a dot so its start and end meet. It stays still when **Theme settings → Motion** is off or the device asks for reduced motion, and screen readers read the text once. ## Marquee The **Marquee** block moves a row of short **Items** across, each a text with an optional icon or small picture and a link. Set the **Time per loop**, the **Direction**, the **Text size**, the mark **Between items**, a slight **Tilt**, **Outlined text** and faded edges. The row stops while the shopper points at it or moves into it with the keyboard; with **Theme settings → Motion** off or reduced motion it stands still and wraps, so every item stays readable. For a full-width band, use the **Scrolling text** section. ## Collection card The **Collection card** block shows one collection as a card, in the style of **Theme settings → Collection cards**, with your own **Heading** and a short **Text** if you like, a shape of its own (or the theme's) and the product count. Put several in a row group to build your own collection grid. ## Product list The **Product list** block shows products from a collection, or up to twelve you pick, as the theme's product cards. Set how many, the **Columns on computers** and on phones, and **Swipe on phones** for one row that scrolls sideways. Put it next to a text or an image card in a group to build a layout of your own. ## Tabs The **Tabs** block shows a row of titles that switch the content below them, so long information fits in a small space. Each **Tab** has a title and a text, and you can add other blocks inside it: buttons, images, a product list, even an accordion. - **Tab style**: **Pills** (the theme's control tray), **Underline** or **Text**. - **Title size**, **Tab alignment** and **Tab color** (closed tabs show the color lighter). - **Content**: its alignment, the space above it, and a **Background** for a color box behind it, with its own text color and padding. Shoppers can also move between tabs with the arrow keys. With one tab, only its content shows. On phones a long row of titles scrolls sideways. ## Pop-up link The **Pop-up link** block is a text link or a button that opens a panel instead of a new page: a size note, delivery details, a care guide or a short story. Put it in any section. - **Button style**, **Icon** (or an **Icon image** of your own) and **Icon position** set how the link looks. - **Pop-up**: a **Heading**, a **Text**, a **Page** whose content shows in the panel, and any blocks you add inside it (images, buttons, a product list, an accordion). - **Opens as**: a **Pop-up** in the middle of the screen (a sheet from the bottom on phones) or a **Drawer** from the side, with its **Width** and **Corners**. - **Own color scheme**: off, the panel follows **Theme settings → Dialogs**. The panel keeps keyboard focus inside while it is open and closes with Escape or a click on the shade. In the theme editor, selecting a block inside the pop-up opens it. ## Article card The **Article card** block shows one blog post you choose as a card, in the same design as the Journal stories cards. Use it beside a text, in a group, or to put one guide in front on a landing page. - **Type**: **Photo above** the text, **Text on photo** (over a soft shade) or **Photo beside** the text. - **Image shape** and **Image shape on phones**: Theme settings, the photo's own shape, square, portrait or landscape. - **Alignment** and **Heading tag**. - **Show**: the tag, reading time, date, author, excerpt and the Read link. Shape, alignment, tag and reading time start from **Theme settings → Blog cards**; the block can set its own. ## Big text The **Big text** block sizes one line to fill the width it is given, like the wordmark at the bottom of the footer: a campaign word, a slogan or a race name. Italic words take the highlight look from **Theme settings → Text styles**. - **Font**: **Text styles → Display**, or the body font in bold. **Uppercase** and **Outline only** (best on a plain background). - **Text color**, **Alignment** and **Largest size**, which stops a short word from growing too big on wide screens. - **Heading tag**: Paragraph keeps it decorative; pick H1 or H2 only when it is the title. A text too long to stay readable on one line wraps instead of being cut off. ## Menu The **Menu** block shows a menu from **Online Store → Navigation** as links, anywhere a block fits: a help list beside a contact text, a row of quick links under a heading, or a small sitemap. - **Layout**: **List** (with **Show sub-links** for a second level), **Row**, or **Columns with sub-links**, where each top link heads a column. - **Heading** (empty: none), **Title size**, **Space between links** and **Underline on hover**. The page the shopper is on is marked in bold. ## Map The **Map** block shows a Google map of an **Address**, or of a point when you fill both **Latitude** and **Longitude**. Like Store locations, nothing loads from Google until the shopper selects **Show map**: the page stays fast and needs no cookie consent first. A **Cover image** (or a quiet street pattern with a pin) stands in until then. - **Place name** is read out to screen readers; **Zoom**, **Height** and **Height on phones**, and **Corners**. - **Load right away** shows the live map at once instead. - **Show a directions link** adds a Get directions link under the map that opens Google Maps. ## Details list The **Details list** block shows label and value pairs, like the Fabric facts on product pages: specifications, what's in the box, opening details or race facts. - **Rows**: one row per line, written as `Label: value`. A line without a colon shows as a value alone. - **Product metafield**: on product pages, a metafield with the same lines (for example `custom.specs`) replaces the rows, so one template serves every product. - **Detail** blocks add rows one by one after those, with bold or links in the value. - **Layout**: **Rows** (label beside value) or **Grid** (label above value, 2–4 columns, 1 or 2 on phones). **Style**: Lines, Striped or Plain. **Text size** and an optional **Heading**. ## Tags The **Tags** block turns one comma-separated line, such as `Windproof, 180 g, Two zip pockets`, into short points: a quick way to list what a product or a service gives. - **Style**: **Pills** (outlined), **In a line**, or **List** (one point per line). - **Icon**: a **Tick**, a **Dot** or none, with its own **Icon color**. - **Text size** and **Space between points**. Tags are not links; for links use buttons or the Menu block. ## Floating image The **Floating image** block places a decorative photo freely over its section, like the images around a sign-up form: add it to a **Rich text** section (with a heading and an **Email signup** block for a newsletter band), inside a group, or to the **Drop countdown** section. - **Position**: where the image's center sits, from the left and from the top (0–100). **Layer** puts it behind or in front of the content; **Other position on phones** and **Hide on phones** help on small screens. - **Width** and **Width on phones**, **Image shape**, **Rotate**, **Corners** and **Shadow**. - **Loop animation** floats it slowly up or down (still when Motion is off). The image takes no room in the layout and never catches clicks. Give the section enough top and bottom spacing so the images have space around the content. ## Accordion The **Accordion** block holds rows that open to show their text. Each **Row** has a heading, a text, an optional **Icon** before the heading, and can start open; you can also add blocks inside a row, such as a button or an image. On the accordion, **Rows open** lets several rows stay open or keeps one open at a time, **Style** draws the rows as lines or as cards with **Space between cards**, **Toggle icon** is a plus or an arrow, and **Title size** sets the row headings. The older **Collapsible** block stays for single rows. ## Every shared block @theme_blocks()