Skip to main content
Theme blocks are the reusable content pieces of Olympus. Headings, text, buttons, images, videos, labels, countdowns, and cards are all separate blocks that you add to a section and arrange in the Theme Customizer. A section supplies the layout, media, spacing, and color scheme; the blocks supply what appears inside it. Because the same Heading block is used in a hero banner, a newsletter popup, and a product page, you learn each block once and can apply that knowledge across the whole store.

​
What theme blocks control

  • The text content of a section: headings, paragraphs, labels, and button copy
  • Media placed inside a section’s content area: images and videos
  • Layout inside a section: grouping blocks into columns, rows, or cards
  • Commerce content: prices, product cards, collection cards, and promotional content cards
  • Custom code inserted through the Custom Liquid block

​
How blocks work in Olympus

Every section lists the blocks it accepts. Most content sections accept Heading, Text, and Button, and add the blocks that fit their purpose, such as Label in the Callout banner or Image in the Newsletter banner. The Product, Article, and Custom section accept any theme block, so you can compose those layouts freely. The Group block also accepts any theme block, which lets you nest a column or row of blocks inside a section that would otherwise accept only a few. Some blocks belong to a single section and are documented on that section’s page rather than here. Examples include Slide in the Hero banner, Tile in the Header, Multi tile, and Dual tile, Testimonial in Testimonials, Feature in Feature highlights, and the footer’s Text column, Menu, Newsletter, Follow on Shop, Logo group, and Spacer blocks.

​
Adding, reordering, and nesting blocks

1

Open the Theme Customizer

From your Shopify admin, open Online Store, then Themes, and click Customize on Olympus.
2

Select a section

Click a section in the left sidebar. Its existing blocks appear nested underneath it.
3

Add a block

Click Add block under the section and choose from the list. Only blocks the section accepts are offered.
4

Reorder or nest

Drag a block up or down to reorder it. Drag a block onto a Group block, or use Add block inside the Group, to nest it. Use the eye icon to hide a block without deleting it.
Block settings such as Size and Alignment apply to that block only. The section’s Common settings, including Width and Color scheme, still frame everything inside it. See Common settings.

​
Block reference

Content blocks carry the words a customer reads. They have no media or background of their own and take their colors from the section’s color scheme.
A section or block title with rich text support, so you can bold or link single words.
  • Heading: the text. Default: Talk about your brand.
  • Heading level: H1 to H6. Sets the semantic level for accessibility and search engines; it does not change the size. Default: H2.
  • Size: Extra small, Small, Body, or Heading 6 up to Heading 1. Default: Heading 3.
  • Alignment: left, center, or right.
Keep one H1 per page (usually the product or page title) and use H2 for section headings, then adjust Size freely for the look you want.
A paragraph of rich text for descriptions, announcements, or supporting copy.
  • Text: rich text with bold, italic, links, and lists.
  • Size: Extra small, Small, Body, or Heading 6 up to Heading 1. Default: Body.
  • Alignment: left, center, or right.
A call to action styled by the global Buttons theme settings.
  • Button label: default Shop now.
  • Link: the destination.
  • Style: Filled or Outlined. Default: Filled. Colors come from the section’s color scheme (Button, Button label, and Secondary button label).
  • Button type: Text only, or Text with icon to add an arrow.
  • Open link in new tab: off by default.
  • Alignment: left, center, or right.
A short eyebrow line, such as Deal of the day, shown above a heading.
  • Text: default Deal of the day.
  • Label style: Outlined pill, Filled pill, or Plain text. Default: Outlined pill.
  • Corners: Pill or Theme default. Appears for pill styles only.
  • Size: Extra small, Small, or Body. Default: Extra small.
  • Bottom spacing: No, S, M, L, or XL. Extra space under the label, added to the section’s own spacing.
A small sticker pinned to a corner of a tile, such as Promo or New. Accepted by the Tile block used in Multi tile and Dual tile.
  • Badge: the text. Default: Promo.
  • Show icon and Icon SVG code: paste SVG code to display an icon in front of the label at text height. Use the current color in the SVG so it follows the badge color.
  • Badge position: Top left, Top right, Bottom left, or Bottom right. Default: Top left.
Product badges on product cards (sale, sold out, and tag-based badges) are a separate feature controlled under Theme settings, then Product cards. See Product badges.
A timer counting down to a date, used in the Callout banner for sales and launches.
  • Layout: Boxed or Divider. Default: Boxed.
  • Background behind each unit: tints the days, hours, and minutes boxes. Boxed layout only. On by default.
  • End date: Year, Month, Day, Hour, and Minute.
  • Units: Show days, Show hours, Show minutes, and Show seconds, all on by default.
  • Message after end date: shown once the timer reaches zero. Default: The sale has ended.
Only use countdowns for genuine deadlines. Leaving an expired timer in place, or resetting it repeatedly, erodes customer trust.
An image paired with a highlighted word in the Animated rich text section. Bold a word in the heading or text to make it a highlight; each Highlight image block is matched to a highlight in order for the hover, stack, inline, and framed effects.
  • Image: shown on desktop for the reveal, stack, and framed effects. In the inline icons effect, images also show on mobile.
See Animated rich text for the effects and highlight colors.

​
Best practices

Separate level from size

Choose Heading level for document structure and Size for appearance. A visually large H2 keeps the page accessible without forcing a second H1.

Group before you duplicate

When you need two columns of content, put a Group block around each column instead of adding many loose blocks. Groups are easier to reorder and restyle later.

Prefer hosted video

Upload videos to Shopify files rather than linking YouTube or Vimeo. Hosted video loads faster, has no third-party branding, and supports autoplay reliably.

Use labels sparingly

One Label above a heading adds hierarchy. A label on every section turns into noise and weakens the ones that matter.

Keep countdowns honest

Set a real end date and a clear Message after end date. Remove the block once the campaign is over.

Contain custom code

Keep custom snippets inside Custom Liquid blocks so theme updates continue to apply to the rest of the theme.

Common settings

The width, spacing, border, and color scheme controls that frame every block.

Custom section

A blank section that accepts any theme block for fully custom layouts.

Product Page (PDP)

Product-specific blocks alongside the shared library.