Four sections handle the commerce surfaces outside the PDP. The cart and collection sections render the cart page and PLP respectively. The category archive and bundle sections are home-page patterns — the first surfaces collection tiles, the second is a hotspot-driven “complete the look” picker.Documentation Index
Fetch the complete documentation index at: https://voyage-theme.fasil.in/llms.txt
Use this file to discover all available pages before exploring further.
| Section | Where it lives |
|---|---|
Cart (main-cart) | The cart template. |
Collection (main-collection) | The collection template — the PLP. |
| Home · Category archive | Any template. Designed for the home page. |
| Home · Bundle | Any template. Designed for the home page. |
Cart — sections/main-cart.liquid
The full-page cart. Renders line items with thumbnails, variant options, selling plans, unit pricing, line-level discounts, quantity steppers, cart-level discount applications, an optional note field, accelerated checkout buttons, and the primary checkout CTA. Empty-state shown when cart.item_count == 0.
Available on: Cart template.
Section settings
Header
Eyebrow above the page heading.
Page heading. Falls back to the
cart.general.title translation if blank.Empty state
Message shown when the cart is empty. Falls back to the
cart.general.empty translation.Continue-shopping button label in the empty state.
Continue-shopping destination.
Cart note
Show the “note to merchant” textarea in the order summary sidebar.
Label above the note field.
Placeholder inside the note field.
Checkout
Primary checkout button label. Falls back to the
cart.general.checkout translation.Blocks
None — the cart section’s layout is fixed.What renders automatically
The section pulls in several Shopify cart features without configuration:- Selling plans —
item.selling_plan_allocation.selling_plan.nameis rendered under the line item title. - Unit pricing —
item.unit_price_measurementrenders as{price}/{reference_unit}. - Line-level discounts — Each
item.line_level_discount_allocationsentry is shown as a strike-through saving. - Cart-level discounts —
cart.cart_level_discount_applicationsrender as their own row in the order summary. - Tax indicator —
cart.taxes_includedshows the “Taxes included” line under the subtotal. - Accelerated checkout —
content_for_additional_checkout_buttonsis rendered for Shop Pay, Apple Pay, Google Pay, PayPal, etc.
When to use
There’s one cart section per theme — this is it. The cart drawer (rendered separately as a snippet) shares the same data; configure both so they match in tone. For checkout-page branding (logo, colors), see Customization · Checkout branding.Collection — sections/main-collection.liquid
The collection / PLP template. Two-column body: filter sidebar on the left, paginated product grid on the right. Above the grid sits a sticky toolbar with chip nav, filter toggle, count, view-mode picker (2/3/4/list), and sort dropdown. Optional collection-image banner at the top, optional editorial studio-note module at the bottom.
Available on: Collection template.
Section settings
Header
Show the collection’s featured image (from admin) as a full-width banner with overlaid title + description.
Show the title + description without a banner image. Quieter than the banner option.
Navigation
Show the horizontal scrolling category chips above the filter toolbar.
Comma-separated chip labels. First entry is the “All” / catch-all label. Each chip links to
/collections/all?type={label}.Show the filter sidebar. Filters come from Online Store → Navigation → Filters in admin.
Grid
Default columns. Options:
2, 3, 4. The visitor’s view-mode picker choice persists in localStorage and overrides this.Products per pagination page. Range 12–48, step 4.
Message shown when a collection has no products.
Editorial note
Show the editorial studio-note module below the product grid.
Eyebrow above the studio note.
Coordinate / location line shown on the right of the eyebrow row.
The studio quote body.
Attribution line below the quote.
Blocks
None — the PLP layout is fixed.What renders automatically
- Filter sidebar — Auto-renders
collection.filters(list,price_range). Color filters render as swatches keyed off the handleized value. Size filters render as chip buttons. Other list filters render as checkbox lists with counts. - Sort dropdown — Renders
collection.sort_optionsas a popover listbox. - Pagination —
default_paginationis used. - Structured data — Emits
CollectionPageandBreadcrumbListJSON-LD.
When to use
There’s one collection section per theme — this is it. Tunechip_labels to match your catalog vocabulary, decide whether to show the banner or the quiet title-only treatment, and enable the studio-note module if the collection benefits from an editorial frame.
Home · Category archive — sections/home-category-archive.liquid
Dark navy band with a grid of category tiles. Each tile is one Shopify collection — the collection’s title, image, and product count are pulled in automatically, with merchant-controlled fallbacks for collections that don’t have an image set yet.
Available on: All templates. Designed for the home page.
Section settings
The script-font section heading rendered at the top of the band.
Scales the heading 60–140%.
Reserved for a longer heading treatment (not rendered in the current default layout — kept in schema for backwards compatibility).
Reserved for the sans companion to
script (same status — schema retains it).Body paragraph (currently not rendered in the default layout).
Card subtitle (used by older variants — not rendered in current default).
Footer text (used by older variants — not rendered in current default).
Five of the section-level fields above (
script, sans, body, subtitle, footer_left) are retained in the schema for backwards compatibility with earlier layouts. The current layout renders only the eyebrow heading. The fields remain editable so older installs don’t lose data on upgrade.Blocks
Category (max 8)
Each block is one category tile. The default preset ships with 6.The Shopify collection behind this tile. Provides the title, image, URL, and product count automatically.
Optional override image. Used when the collection’s own image is not what you want for this tile.
Title used if no collection is selected. For preview / setup.
Piece count used if no collection is selected.
URL used if no collection is selected.
Unsplash photo ID used as the last-resort image when no collection or override image is set.
Default preset
Six category blocks, blank-defaulted for the merchant to point at their own collections.When to use
Category archive is the home-page index of the whole catalog. Use it when you want to surface 6–8 collections as visual tiles — typical for fashion houses with seasonal wardrobes (Shirts / Trousers / Knits / Outerwear / Swim / Accessories) or multi-vertical brands. For two large hero tiles, use Home · Chapters. For a quieter list of collections on a content page, use the standalonecollection-list.liquid (see Sections overview).
Home · Bundle — sections/home-bundle.liquid
“Complete the look” — a hotspot-driven product picker on a stage image. Merchants place dots at x/y positions on the image; each dot is one Shopify product. Clicking a dot reveals a small product card with add-to-bundle controls. The total updates as items are selected, with an optional list-price multiplier to show a saving versus à-la-carte.
Available on: All templates. Designed for the home page.
Section settings
The script-font heading.
Scales the heading 60–140%.
The stage image — typically a styled flat-lay or model shot showing all the products together.
Unsplash photo ID used if no stage image is set.
List-price multiplier × 100.
112 means the strike-through “list” price is 12% above the bundle total — i.e. the bundle is positioned as a 12% saving. Set to 100 to remove the saving line.Blocks
Hotspot (max 8)
Each hotspot is one product placed at a coordinate on the stage image.The Shopify product behind this hotspot. The block uses
product.selected_or_first_available_variant to get the variant ID and current price.Horizontal position 0–100% of the stage image width.
Vertical position 0–100% of the stage image height.
Which side of the dot the product card opens. Options:
right, left.Selected by default. Lets the merchant pre-select 1–2 items so the bundle has a starting total on first paint.
Display name if no product is selected. For preview / demo.
Display price (number, no currency) used if no product is selected.
Unsplash photo ID used if no product is selected.
Default preset
Four hotspot blocks, blank-defaulted.When to use
Bundle is the home page’s interactive moment — visitors can click around the stage image, build a kit, and add it all to the bag with one button. Use it for:- Capsule wardrobes (“the four-piece summer kit”).
- Outfit-of-the-week features.
- Gift sets where the bundle is itself the product story.
Cross-reference
Product sections
Main product, featured product, featured collection, related, complementary.
Interactive features · Cart drawer
The cart drawer that mirrors
main-cart.Templates · Collection page
The collection template and how
main-collection is configured by default.