Documentation

Understand the theme editor: sections, blocks and templates

Open the Shopify theme editor, choose a page to edit, add, move or hide sections and blocks, check mobile and save.

The whole Story Theme layout is set up in Shopify's theme editor, without a single line of code. This article gives you the four concepts to know (template, section, block, theme settings) and the actions you'll repeat every day.

Open the editor

  1. In your Shopify admin, open Online Store > Themes.
  2. Click Edit theme next to the Story Theme (or its copy).
  3. The editor opens: the store preview in the center, the list of the page's elements on the left, the settings of the selected element on the right.
Screenshot to take — Shopify theme editor > Story Theme Home page template (Basic 4.0.0): overview with the top bar (template selector, desktop/mobile icons, Save button), the list of sections on the left (Header, template sections, Footer) and the preview in the center, no section selected

The four concepts to know

ConceptWhat it isExample
TemplateThe layout of a type of page. All products that use the same template share the same layout.Home page, Products > Default product, Collections > Default collection
SectionA large horizontal band of the page.A banner, a product list, an FAQ
BlockAn element inside a section.A heading, a text, a button, an image
Theme settingsThe settings shared by the whole store.Colors, fonts, buttons, rounded corners

In the Story Theme, almost every section is a frame you fill with blocks. An "Image with text" section is only a starting point: you can add any block from the theme (a button, stars, a checklist…) or remove some. The Group block lets you arrange several blocks side by side or stacked.

The first screen of the Ma Petite Ruche demo store: the announcement bar and header at the top, then a Banner section made of blocks (badge, heading, text, checklist, two buttons) next to its photo
The first screen of the Ma Petite Ruche demo store: the announcement bar and header at the top, then a Banner section made of blocks (badge, heading, text, checklist, two buttons) next to its photo

In the screenshot above, the band containing the heading and the photo is one section (a Banner); the small badge, the heading, the paragraph, the checklist and the two buttons are its blocks. Each one can be edited, moved or deleted separately.

The Header (including the announcement bar) and the Footer are shared by every page: what you change there applies everywhere.

Choose the page to edit

The dropdown menu at the top of the editor (it shows Home page when it opens) lets you switch templates: Products > Default product, Collections > Default collection, Pages, Cart… You can also click a link in the preview: the editor follows your navigation.

Each template has its own layout. On the same store, the product page and the collection page look nothing like the home page, but they share the header, the announcement bar and the colors:

The Product template on Ma Petite Ruche: gallery on the left, buy column on the right with variants, quantity offers and Add to cart button
The Product template on Ma Petite Ruche: gallery on the left, buy column on the right with variants, quantity offers and Add to cart button
The Collection template on Ma Petite Ruche: breadcrumbs, collection banner, product count, grid density and sorting
The Collection template on Ma Petite Ruche: breadcrumbs, collection banner, product count, grid density and sorting

Add a section

  1. In the list on the left, click Add section where you want it.
  2. Browse the categories (Banners, Products, Image and text, Reviews and trust, Scroll effects, Popups…) or type a word in the search.
  3. Choose a ready-made preset, for example Split banner or Product carousel. It comes with blocks already in place, which you then edit.
Screenshot to take — Shopify theme editor > Home page template > "Add section" button clicked: picker window open on the Banners category, with the Image banner, Split banner, Video banner, Slideshow presets visible and a preview on hover

To see every section before choosing, open the catalog that ships with the theme: in the template menu, open Collections and choose one of the templates whose name starts with sections- (banners, products, media…). Each page shows a category's presets as they appear on the store. Each section's description, with its variants in pictures, is also in the Sections part of this documentation, for example the Banner section or the Product list section.

The Collection tabs preset of the Product list section, as it appears on the products catalog page
The Collection tabs preset of the Product list section, as it appears on the products catalog page

Add, edit and move a block

  1. Expand a section in the list on the left (small arrow next to its name).
  2. Click Add block inside the section and choose the block.
  3. Click a block to open its settings on the right: text, style, size, alignment…
  4. To change the order, drag the section or block by its handle (the six dots to the left of its name).

Each section also has its own settings (click its name): Color palette, width, spacing, Separators, Animation…

Heading, Text and Button blocks together in the same section
Heading, Text and Button blocks together in the same section

The most common blocks are described in Text blocks and Layout blocks.

Screenshot to take — Shopify theme editor > Home page template > Banner section expanded on the left (Heading, Text, Group blocks with two Buttons), Heading block selected, block settings panel open on the right, drag handles visible

Hide or delete

  • Hide: hover over the section or block and click the eye icon. The element disappears from your store but keeps all its settings: that's the right option for a seasonal offer. A hidden element shows a crossed-out eye.
  • Delete: open the element and click Remove section or Remove block, at the bottom of its settings.
The Sylys demo newsletter popup, once shown again: photo on the left, email field and "No thanks" link
The Sylys demo newsletter popup, once shown again: photo on the left, email field and "No thanks" link

Check how it looks on mobile

Most of your visitors arrive on a phone. At the top of the editor, click the mobile icon to switch the preview to phone width, then go back to desktop with the icon next to it.

The same home page on desktop and mobile: on phones, the text moves above the image
The same home page on desktop and mobile: on phones, the text moves above the image

Most blocks have a Show on setting (Desktop and mobile, Desktop only, Mobile only). For a different layout on phones, duplicate the block and set one to Desktop only and the other to Mobile only. Don't overdo heavy duplicates (videos, large images): a block hidden this way is still loaded in the page.

Save

Click Save in the top right. Until you save, nothing is applied. On an unpublished theme, saving changes nothing for your customers: you'll publish the copy once it's ready.

Learn more