Main collection

sections/main-collection.liquid

Settings

Setting	ID	Type	Default	Notes
Blocks marked (above) render above the product grid. Every other block renders below it, whatever order they appear in here.
Layout
Show breadcrumbs	show_breadcrumbs	On/off	On
Filter sidebar width	sidebar_width	Slider	290	Range: 240–320 step 10.
Products per page	products_per_page	Slider	24	Range: 8–48 step 4.
Columns on desktop	columns_desktop	Slider	4	Range: 2–5 step 1.
Columns on tablet	columns_tablet	Slider	3	Range: 2–4 step 1.
Columns on mobile	columns_mobile	Dropdown	2	Options: 1 column, 2 columns.
Filters
Keep filters visible while scrolling	sticky_sidebar	On/off	On
Filter groups open by default	filter_groups_open	Slider	5	Groups beyond this start collapsed. Opening every group makes a long filter list hard to scan. Range: 0–10 step 1.
Price filter	filter_price_style	Dropdown	slider	Slideshow only hides the number fields visually. They remain available to screen readers, since typing an exact price is easier than dragging to it. Options: Slideshow only, Slideshow and number fields.
Toolbar
Show grid / list toggle	show_grid_toggle	On/off	On
Below the grid
To hide a section on one collection only, add a collection metafield called custom.hide_sections (List of single line text) and enter any of: categories, benefits, seo, faq, related.
Two sources. The blocks you add below show on every collection. A collection that has its own metafield entries shows those instead, and ignores the blocks. Fill in metafields only for the collections that need different content — the rest fall back to the blocks.
Headings below accept [collection], replaced with the collection's name. So "About [collection]" reads "About Massage Oils" on that page. [Collection] and [COLLECTION] work too.
Benefit cards heading	benefits_heading	Text	Why shop [collection]	Add one Benefit card block per card. Keep them next to each other so they form a single row.
Per-collection benefits metafield	benefits_metafield	Text	custom.benefits	Leave as is unless you renamed the metafield. Collections with entries here override the Benefit card blocks. Set up per-collection cards.
Benefit card icon position	benefits_icon_position	Dropdown	above	Options: Above text, Beside text.
Benefit card icon size	benefits_icon_size	Slider	24	Range: 16–48 step 4.
Dividing lines between benefit cards	benefits_divider	Dropdown	line	Desktop only. Two columns on mobile are too narrow for vertical rules. Options: None, Vertical lines.
FAQ heading	faq_heading	Text	Frequently asked questions	Add one FAQ item block per question. Keep them next to each other in the block list — a different block between them starts a second FAQ group with its own heading.
Per-collection FAQ metafield	faq_metafield	Text	custom.faqs	Collection metafield holding a list of FAQ metaobjects with question and answer fields. When a collection has entries, they replace the FAQ blocks below. Leave the metafield unset on a collection to use the blocks.
Open one FAQ answer at a time	faq_single_open	On/off	Off
Include FAQ structured data	enable_faq_schema	On/off	On	Publishes the FAQ blocks above as structured data. Switch off if you also add a separate FAQ section to this page. Two sets on one URL disqualifies both.
Include collection structured data	enable_collection_schema	On/off	On	Outputs CollectionPage and a list of the products on this page. Turn off if an SEO app already adds it, so the page does not emit it twice.
Product cards
Image ratio	image_ratio	Dropdown	1 / 1	Options: Square (1:1), Portrait (4:5), Tall (3:4).
Show Quick Add	show_quick_add	On/off	On
Show vendor	show_vendor	On/off	On
Show rating	show_rating	On/off	On
Show color swatches	show_swatches	On/off	On
Show second image on hover	show_second_image	On/off	On
Show wishlist button	show_wishlist	On/off	Off	Displays the button and fires a neroli:wishlist:toggle event. Requires a wishlist app to store the list.

Blocks

Collection hero (above) (hero)

Setting	ID	Type	Default	Notes
Show collection description	show_description	On/off	On
Shorten description with Read more	clamp_description	On/off	On	Keeps long descriptions from pushing products below the fold. Full text stays on the page for search engines.
Lines before Read more	description_lines	Slider	2	Range: 2–6 step 1.
Show product count	show_count	On/off	Off	The toolbar above the grid already shows a count, and that one updates as filters are applied.
Show collection image	show_image	On/off	On
Show image on mobile	show_image_mobile	On/off	On
Fallback image	image	Image		Used only for collections that have no image of their own. Set each collection's image in Products → Collections.
Image style	image_style	Dropdown	bleed	Full bleed takes its height from the hero and ignores the image ratio below. Options: Full bleed to page edge, Contained with rounded corners.
Image height	min_height	Slider	220	Height of the bleed image on desktop. The hero grows taller if the text needs more room. Range: 160–400 step 20.
Image ratio	image_ratio	Dropdown	3 / 2	Options: 16:7, 16:9, 3:2, Square.
Text column width	text_width	Slider	60	Range: 50–70 step 5.

Shop by category (above) (subcategories)

Setting	ID	Type	Default	Notes
Heading	heading	Text	Shop by category
Menu	menu	Menu picker		Links to collections show an image and product count. Other link types render as text.
Show product count	show_count	On/off	On
Card width on desktop	card_width	Slider	190	Range: 160–240 step 10.

Benefit card (benefit_card)

Setting	ID	Type	Default	Notes
Fallback card. Shows on every collection that has no benefits metafield entries of its own. Add one block per card.
Icon	icon	Dropdown	leaf	Options: None, Leaf, Flower, Droplet, Heart, Shield, Award, Star, Gift, Delivery, Returns, Support, Question, Smile, Energy, Wellness, Clock.
Heading	heading	Text	About this range
Text	text	Rich text	<p>A short sentence describing this part of the collection.</p>
Link label	link_label	Text	View guide	Describe the destination. Four cards all saying “Learn more” tell a screen-reader user nothing.
Link	link_url	Link

SEO content (seo_content)

Setting	ID	Type	Default	Notes
The content below shows on every collection. A collection with a value in the metafield named further down shows that instead.
Heading	heading	Text	About [collection]
Content	content	Rich text
Per-collection metafield	metafield_key	Text	custom.about	Namespace and key of a collection metafield, e.g. custom.about. When the collection has a value it replaces the content above. Clear this field to always use the content above.
Shorten with Read more	collapsible	On/off	On	Caps the height and adds a Read more control. The full text stays on the page for search engines.
Height before Read more	collapsed_height	Slider	260	Range: 160–600 step 20.
Image	image	Image
Layout	layout	Dropdown	text	Options: Text only, Image left, Image right.

FAQ item (faq)

Setting	ID	Type	Default	Notes
Fallback question. Shows on every collection that has no FAQ metafield entries of its own. Add one block per question.
Question	question	Text	Ask a common question here
Answer	answer	Rich text	<p>Answer it plainly. Useful answers help shoppers and help this page rank.</p>
Open by default	open_by_default	On/off	Off

Related collections (related_collections)

Setting	ID	Type	Default	Notes
Heading	heading	Text	You might also like
Source	source	Dropdown	automatic	Automatic uses the other collections this collection's products belong to, so it differs on every page with no setup. It falls back to the menu below when it finds nothing. Options: Automatic, Per-collection metafield, Menu.
Fallback menu	menu	Menu picker		Used by the Menu source, and whenever Automatic or the metafield finds nothing. The same links show on every collection page.
For the metafield source, add a collection metafield with namespace and key custom.related_collections, type List of collections, then set it per collection.
Card style	card_style	Dropdown	below	Keep this different from Shop by category so the two sections do not look alike. Options: Image with title below, Title over image, Compact row.
Maximum collections	limit	Slider	4	Range: 2–8 step 1.
Show product count	show_count	On/off	On

Maximum blocks: 30