# Sections

Chapter 4 of the Wick user guide.

Add a section in the theme editor with **Add section**. Most sections share a centered section heading: a **Kicker** (the small italic line with a flame above the heading), a **Heading**, a **Subheading**, **Heading alignment** (Centered or Left), and a **Link label** and **Link** that show under the section as a centered key. **Background** is Page, Band (the honey or sage surface color) and, on some sections, **Glow band** (the band with candlelight glowing through it) or **Dusk band** (the dark band). A section that needs a product or collection shows placeholder cards until you choose one, so choose one before you publish. Sections whose content is empty, such as a collection with no products or testimonials with no quotes, take no space on your storefront.

## Home page and content sections

| Section | What it's for | Key settings |
| --- | --- | --- |
| **Hero** | The big opening block (home and page templates) | **Layout**: **Scene with a label** (a full-width candlelit photo with the copy on a big paper label, never on the photo; without an image the scene is a dusk band), **Split** (the copy beside the image in a glow well) or **Spotlight on dusk** (the image in a glow well beside the copy on the dark band). Kicker, **Heading**, **Body**, **Primary button label** and link, **Secondary button label** and link, and **Facts** (short facts under the keys, separated by \|, such as 50+ hour burn \| Soy and coconut wax \| Lead-free cotton wicks). Media: **Image**; for Scene, **Image on phones**, **Image focus** (Center or Bottom), **Height** (Short, Medium or Tall) and **Label position** (Center, Left or Right); for the other layouts, **Image fit**; and **Glow color** (blank uses candlelight). |
| **Slideshow** | Several heroes in turn (home, page and collection templates) | **Layout** (Scene with a label or Split), **Height** (Scene), **Rotate slides automatically** (off) and **Change slides every** (7s, 5 to 10). Up to six **Slide** blocks: image, kicker, heading, text and two buttons. Shoppers get a pause button, and slides never rotate for visitors who prefer reduced motion. |
| **Shop by scent** | A row of scent family tiles that open your products filtered by family | See chapter 9 |
| **Featured collection** | A grid of vessel cards | **Collection**, **Products to show** (8, 2 to 12), **Columns on desktop** (3 or 4), **Layout** (Grid or Carousel) and Background. The link defaults to the collection ("Shop all"). |
| **Featured product** | One product with its scent notes and buy buttons | **Product** and **Layout**: **Spotlight on dusk** (the product in a glowing well on the dark band, with the kicker "Scent of the month", its notes and a candle-gold key; **Glow color**) or **Gallery and buy box** (the product page's gallery and buy box, with **Background** and **Enable image zoom**). The pre-order settings (chapter 6) and these blocks: Title, Product vendor, Price, Scent notes, Inventory, Variant picker, Description, Buy buttons, Product link, the theme blocks of chapter 5 and app blocks. |
| **Build a gift box** | A three-step box builder | See chapter 10 |
| **Gift sets** | Ready-made sets you sell as one product each | Each **Gift set** block: **Product** (the set as one product: its price and stock are what the key adds), **Tag** (a small tag on the label, such as Save 10%), **Heading** (shown until a product is chosen), **Tagline**, **Kit contents** (a bulleted list, with flame bullets) and **Button label** ("Add set to bag") |
| **Image with text** | A story beside an image | **Image**, **Media position** (Left or Right), **Image style** (Glow well or Plain image), **Image fit**, **Image ratio** (Square 1:1, Landscape 6:5 or Portrait 4:5), **Glow color**, **Stat** and **Stat label** (a big number on a small label over the image's corner, such as 50+ / hours of burn), kicker, heading, **Body** (bulleted lists get flame bullets), **Signature** (in italics under the text, such as the makers' names), a button (**Style**: Key or Text link) and **Background** (Page, Band, Glow band or Dusk band) |
| **Testimonials** | Up to six customer or press quotes on paper labels | Each **Quote**: **Quote**, **Name** ("Customer name, town"), **Detail** (what they bought, or where the quote is from) and **Rating** (5, 0 to 5; 0 hides the stars, for press quotes). Background defaults to Band. Use real quotes only, and rewrite the default heading ("Lit in 4,000 homes, and counting") with your own words. |
| **Shop the shelf** | A shelf or table photo with pins on the things you sell | **Image** (shown uncropped, so pins stay on what they mark). Up to twenty **Hotspot** blocks: **Product** (its card shows the notes, price and an Add key), **Label** (blank uses the product's title), **Horizontal position** and **Vertical position** (0 to 100%) and **Detail** (such as 220 g · 50 hours) |
| **Promises** | Up to six short promises with icons | **Columns on mobile** (1 or 2). Each **Promise**: **Icon** (None or one of 21 icons, from Flame, Truck and Leaf to Lock and Globe), **Heading**, **Text** and **Link**. State only terms your store actually offers. |
| **As seen in** | Up to twelve press or stockist logos | **Logo colors** (Original, or Monochrome in one flat color that suits the palette; use transparent logos), **Logo height** (40px, 24 to 96), **Layout on mobile** (Wrap or Scroll). Each **Logo** needs an **Image** and a **Company name** (a logo without a name isn't shown), with an optional **Link** and **Quote**. |
| **Rich text** | Free text and buttons | **Heading alignment** and **Background** (Page, Band, Glow band or Dusk band). Add Kicker, Heading, Text and Button blocks. |
| **Section** | An empty section you fill with blocks | Takes any theme block and app blocks |
| **FAQ** | Questions and answers | Add **Collapsible row** blocks (chapter 5). Background: Page, Band or Glow band. |
| **Newsletter** | An email sign-up band | Kicker ("The scent list"), heading, subheading, **Button label** ("Sign up"), **Customer tag** ("newsletter") and **Background** (Dusk band, Page, Band or Glow band) |
| **Blog posts** | Your latest articles | **Blog** (shows its newest articles) or **Articles** (picked by hand, in your order), **Articles to show** (3, 2 to 12), **Show excerpts** (off), Background (Page or Band); the link defaults to the blog |
| **Custom Liquid** | App snippets or your own code | **Liquid** and **Background** (Page, Band or Dusk band) |

## Product page sections

| Section | What it's for |
| --- | --- |
| **Product** | The gallery and the buy box (chapter 6) |
| **Product details** | The rows under the product: the burn label (**Spec table**), **Care and safety** and **Collapsible row** blocks (chapter 11). **Background**: Page or Band. |
| **Product recommendations** | A row of vessel cards. **Recommendation type**: Related products (similar ones) or Complementary products (ones that pair with this product; you choose them in the Search & Discovery app). **Products to show** (4, 2 to 10) and Background. The presets show "Pairs well with" (complementary) and "You might also like" (related). |
| **Quick order list** | For B2B customers: every variant of a product in a table with quantity fields. **Heading** ("Quick order"), **Variants per page** (25, 10 to 50) and **Show SKU** (on). |

## Page sections

* **Page**: your page's content, with **Show breadcrumbs**, a **Kicker** and a facts panel (**Facts heading**, "At a glance") filled with **Fact** blocks (label and value, such as Burn time: 50 hours).
* **Contact form**: **Kicker** ("Say hello"), **Form heading** ("Send us a note") and **Show order number field** (on), with **Menu column** blocks (quick links) and **Text** blocks (a heading and text, such as your address) beside the form.
* **Collections grid** (the collections list page): **Heading**, **Body**, **Collections** (empty lists every collection), **Tile glow** (blank uses candlelight), **Word after the count** ("products") and **Collections per page** (12, 4 to 24).
* **Collection** and **Search**: chapter 13. **Blog**: **Show breadcrumbs**, **Kicker** ("From the studio"), **Body**, **Show featured entry**, **Show tags**, **Show excerpts** and **Articles per page** (9, 6 to 30). **Article**: blocks for breadcrumb, title, byline (**Show author**), featured image, content, tags and share.
* **404 page**: heading "This wick has gone out.", body and **Show the requested address**.
* **Password**: your "opening soon" page, with a heading ("Something is pouring"), body, an **Image** (a candlelit scene behind the label; without one the page is a dusk band) and a newsletter form (**Show newsletter form**, **Customer tag**).

## Compare

Turn on **Show compare checkbox** in Theme settings › Product cards, create a page with the `page.compare` template and choose it as the **Comparison page**. Shoppers tick up to three products; a tray at the bottom of the screen shows their thumbnails and a **Compare** key. The **Compare** section shows them side by side with price, availability, the scent family, scent strength and burn time (when the products have them; chapter 7), and the rows of its **Spec table** block; add **Spec row** blocks to compare more of your metafields, such as wax or net weight.
