Commerce glossary

Themes, sections and page builders

The look of the storefront and how its pages are put together: theme colours and fonts, page templates, sections and blocks, and the editors that publish them.

62 parts and 26 phrases. Apps in this area include Shopify Online Store 2.0 themes, PageFly, GemPages, Shogun, Replo, EComposer.

Pagesstorefront.pageShowHow a single page is made: its template, its content, its sections and the blocks inside them.
Page templatesstorefront.page.templateShowThe fixed page types a store has, each with its own layout.
PartLitestore todayHow to extend
Home templatestorefront.page.template.homeThe layout of the store's front page.
Coreapp/(web)/page.tsx
Slot · many
Product templatestorefront.page.template.productThe layout of a product page with gallery, buy box, details, reviews and related products.
Coreapp/(web)/product/[slug]/page.tsx
Slot · many
Collection templatestorefront.page.template.collectionThe layout of a page that lists the products in one collection.
Coreapp/(web)/collections/[slug]/page.tsx
Slot · many
Category templatestorefront.page.template.categoryThe layout of a page that lists the products in one category and its subcategories.
Coreapp/(web)/categories/[...slug]/page.tsx
Slot · many
Custom page templatestorefront.page.template.custom_pageThe layout of a page such as About or a landing page, at its own address.
Coreapp/(web)/pages/[slug]/page.tsx
Slot · many
Blog templatesstorefront.page.template.blogThe layouts of the blog index and a single blog post.
Coreapp/(web)/blog
Slot · many
Cart templatestorefront.page.template.cartThe layout of the cart page with items, totals and the checkout steps.
Coreapp/(web)/cart/page.tsx
Slot · many
Not-found templatestorefront.page.template.not_foundThe page shown for an address that does not exist.
Coreapp/(web)/not-found.tsx
Slot · many
Alternate templatestorefront.page.template.alternateA second layout for the same page type that the owner assigns to chosen products or collections.
Plugin
Slot · many
Page contentstorefront.page.contentShowWhat fills a page: its written content and the products listed under it.

How to extend

  • Assistant toolsavePageupdateFeedgetStorefrontThe assistant reads the storefront, writes a page's content and changes its feed.
PartLitestore todayHow to extend
Page HTML contentstorefront.page.content.htmlThe page's written content stored as HTML and shown in a text container.
Coremodules/storefront/pages/page-view.tsx
Assistant tool
HTML cleaningstorefront.page.content.sanitizerRemoves scripts and unsafe attributes from page HTML before it is saved.
Coreplatform/sanitize-html.ts
Assistant tool
Product feedstorefront.page.content.feedA list of products under the page content, chosen by a strategy and an optional collection, with filters.
Coremodules/storefront/feed
Assistant tool
Page recordstorefront.page.content.page_recordA page's name, address, meta title, meta description and on/off switch.
Coremodules/storefront/admin/pages/schema.ts
Assistant tool
Section liststorefront.page.content.sectionsAn ordered list of sections, each with its type and settings, that makes up the page from top to bottom and is checked against the closed list of section types on save.
Coremodules/storefront/sections/catalog.ts
Assistant tool
Theme settingsstorefront.themeShowThe store-wide values every page reads for its colours, fonts, corners and spacing.

How to extend

  • ProviderOne per storestorefront themeOne theme's token set is active per store, and a plugin can add another token set to pick from.
  • Assistant toollistStorefrontThemessetStorefrontThemeThe assistant lists the themes and switches the active one.
PartLitestore todayHow to extend
Theme coloursstorefront.theme.coloursThe colour values for the primary button, background, text, cards, borders, muted text, success and danger.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Heading fontstorefront.theme.heading_fontThe font family used for headings, either a system font or any Google Font.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Body fontstorefront.theme.body_fontThe font family used for body text, either a system font or any Google Font.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Corner radiusstorefront.theme.corner_radiusA base corner size from which buttons, cards and inputs scale their rounded corners.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Text scalestorefront.theme.text_scaleA multiplier applied to every text size on the storefront.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Spacing scalestorefront.theme.spacingA multiplier applied to the space around pages, sections and cards.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Theme presetstorefront.theme.presetA named, ready-made set of all the theme values that the owner picks in one step.
Coreplatform/config/storefront-themes.ts
Provider · oneAssistant tool
Theme picker settingstorefront.theme.pickerThe store setting that stores which preset is active, with a default that uses the stylesheet as it is.
Coremodules/settings/schema.ts
Provider · oneAssistant tool
Logo and brandingstorefront.theme.brandingThe store's logo, name and icon shown in the header, emails and browser tab.
Coremodules/storefront/admin/branding
Provider · oneAssistant tool
Section colour schemestorefront.theme.colour_schemeA named group of colours that one section uses in place of the store-wide colours.
Plugin
Provider · oneAssistant tool
Dark modestorefront.theme.dark_modeA second set of colours the storefront uses when the visitor's device is set to dark mode.
Plugin
Provider · oneAssistant tool
Sectionsstorefront.sectionShowFull-width bands of a page, each of one closed type with its own settings, stacked top to bottom.

How to extend

  • SectionMany side by sideA plugin adds a new section type that the owner places on a page.
PartLitestore todayHow to extend
Announcementstorefront.section.announcementA thin bar of short messages at the top of the page: one fixed, or several rotating.
Coremodules/storefront/sections/announcement-section.tsx
Section · many
Herostorefront.section.heroA large picture or video with a heading, text and buttons: banner, split, collage, slideshow or video.
Coremodules/storefront/sections/hero-section.tsx
Section · many
Marqueestorefront.section.marqueeA strip of short texts scrolling across the page: tags, selling points or outlined words.
Coremodules/storefront/sections/marquee-section.tsx
Section · many
Categoriesstorefront.section.categoriesLive categories linking to their pages, as circles, tiles or chips.
Coremodules/storefront/sections/categories-section.tsx
Section · many
Productsstorefront.section.productsReal product cards from a feed, a collection or chosen products, as a grid or a scrolling row.
Coremodules/storefront/sections/products-section.tsx
Section · many
Feedstorefront.section.feedThe paginated product feed, with its filter rail or as a plain grid.
Coremodules/storefront/sections/feed-section.tsx
Section · many
Spotlightstorefront.section.spotlightOne product large: photo, name, price, text and points, picture left or right.
Coremodules/storefront/sections/spotlight-section.tsx
Section · many
Bundlestorefront.section.bundleTwo to four products sold together, their total, and a real discount code.
Coremodules/storefront/sections/bundle-section.tsx
Section · many
Reviewsstorefront.section.reviewsReal published reviews: a star summary and list, quote cards, or customers' photos.
Coremodules/storefront/sections/reviews-section.tsx
Section · many
Countdownstorefront.section.countdownTime left on a live discount, with its code; gone once it ends.
Coremodules/storefront/sections/countdown-section.tsx
Section · many
Lookbookstorefront.section.lookbookOne picture with products pinned at positions that open the product.
Coremodules/storefront/sections/lookbook-section.tsx
Section · many
Stepsstorefront.section.stepsTitled items in order, such as how it works.
Coremodules/storefront/sections/steps-section.tsx
Section · many
FAQstorefront.section.faqQuestions with answers that expand.
Coremodules/storefront/sections/faq-section.tsx
Section · many
Storystorefront.section.storyOne statement in large type with optional text, link and picture.
Coremodules/storefront/sections/story-section.tsx
Section · many
Comparestorefront.section.compareRows against two to four columns; a value is text or a tick.
Coremodules/storefront/sections/compare-section.tsx
Section · many
Contentstorefront.section.contentA free article: headings, paragraphs, lists, links and images, sanitized.
Coremodules/storefront/sections/content-section.tsx
Section · many
Newsletterstorefront.section.newsletterThe store's email signup, inline or as a banner.
Coremodules/storefront/sections/newsletter-section.tsx
Section · many
Blocksstorefront.blockShowThe small pieces inside a section, which the owner adds, removes and reorders.

How to extend

PartLitestore todayHow to extend
Heading blockstorefront.block.headingA line of large text inside a section.
Plugin
Slot · many
Text blockstorefront.block.textA paragraph of formatted text inside a section.
Plugin
Slot · many
Button blockstorefront.block.buttonA button with a label and a link inside a section.
Plugin
Slot · many
Image blockstorefront.block.imageOne image from the media library inside a section.
Plugin
Slot · many
Product card blockstorefront.block.product_cardOne product's card with image, name and price inside a section.
Plugin
Slot · many
Plugin blockstorefront.block.app_blockA block that a plugin provides and the owner places inside a section or a page slot.
Planned
Slot · many
Editing and publishingstorefront.editorShowHow pages and themes are changed, previewed and made live.

How to extend

  • Assistant toolsavePagesetStorefrontThemegetStorefrontThe assistant writes pages and switches themes through its tools, which the owner approves.
PartLitestore todayHow to extend
Assistant page writingstorefront.editor.assistant_pageThe store's assistant writes or rewrites a page's HTML from the owner's request.
Coremodules/assistant/agent-tools.ts
Assistant tool
Assistant theme switchstorefront.editor.assistant_themeThe store's assistant lists the theme presets and switches the active one.
Coremodules/assistant/agent-tools.ts
Assistant tool
Publish switchstorefront.editor.publish_switchAn on/off switch on each page that shows it on the storefront or hides it.
Coremodules/storefront/admin/pages/page-publication-card.tsx
Assistant tool
Visual editorstorefront.editor.visual_editorA screen that shows the page as shoppers see it and changes sections and blocks in place.
Plugin
Assistant tool
Drag and dropstorefront.editor.drag_and_dropMoves sections and elements on a page by dragging them with the mouse.
Plugin
Assistant tool
Device previewstorefront.editor.device_previewShows the page at phone, tablet and desktop widths before it goes live.
Plugin
Assistant tool
Scheduled publishstorefront.editor.scheduled_publishMakes a page or theme live at a set date and time.
Plugin
Assistant tool
Version historystorefront.editor.version_historyStores earlier versions of a page so the owner can go back to one.
Planned
Assistant tool
Page A/B teststorefront.editor.page_ab_testShows two versions of a page to different visitors and compares their sales.
Plugin
Assistant tool
Template librarystorefront.editor.template_libraryA set of ready-made page and section designs to start a new page from.
Plugin
Assistant tool
Custom codestorefront.codeShowHand-written code an owner or developer adds on top of the theme.

How to extend

PartLitestore todayHow to extend
Custom CSSstorefront.code.custom_cssExtra style rules the owner types in that apply on top of the theme.
Plugin
Slot · many
Custom HTMLstorefront.code.custom_htmlHand-written HTML placed in a page's content.
Coremodules/storefront/pages/page-view.tsx
Slot · many
Custom code sectionstorefront.code.custom_sectionA section whose template code the owner or a developer writes by hand.
Plugin
Slot · many
Web font loadingstorefront.code.web_fontsLoads the Google Fonts the active theme names in one stylesheet request.
Coreplatform/config/storefront-themes.ts
Slot · many

What the phrases mean

The words apps use for a feature, and the plain parts the feature is made of, in the order they happen.

Phrases left out

These phrases mean different things at different apps, so the glossary doesn't map them.

  • themeMeans a whole code package at Shopify and only a set of colours and fonts at many page builders.
  • blockMeans a piece inside a section at Shopify and a whole section at several page builders.
  • global settingsCovers theme values at one builder and store-wide header and footer content at another.

Sources

The app documentation these parts were checked against.