Skip to content

Sections

Sections are the blocks a storefront page is built from — carousels, static content, the footer links. A merchandiser arranges them per channel, and the storefront draws them in the order given.

What is returned

The queries return the published sections of the current channel's active theme:

  • Only published content — unpublished edits held in the admin never appear.
  • Only the active theme's sections — a channel that switches theme keeps its old sections, but they stop being returned.
  • Only sections that are switched on — a section turned off is absent rather than flagged.

Types

TypeWhat it holds
image_carouselSlides, each with an image and a link.
product_carouselA product filter to run and draw as a slider.
category_carouselA category filter to run and draw as a slider.
footer_linksFooter link columns.
static_contentFree HTML and CSS.
services_contentService badges, each with an icon.

type decides the shape of options, so a client switches on it when rendering.

Content and locale

Content is stored per locale. Each section carries translation for the current locale and translations for every locale it has content in. options is a JSON-encoded string; parse it before use.

Queries

QueryPurpose
sectionsThe published sections of the current channel
sectionOne section by ID

Both are public — they need only the storefront key, no customer token.

Released under the MIT License.