Main collection
This page explains how “Main collection” actually behaves, which data it depends on, and what its settings change.
Main collection
This page explains how “Main collection” actually behaves, which data it depends on, and what its settings change.
collection.jsonWhat the theme does automatically
- →
Available filters depend on filters enabled in Shopify Search & Discovery.
- →
Quick add adapts to variant count: direct add or prior selection.
- →
Inventory and review badges require matching product data.
- →
Pagination is calculated by Shopify: the section only loads the configured number of items per page.
- →
Available languages, countries, and currencies come from Shopify Markets settings.
Understand the settings
Header
Configure the texts and elements displayed at the top of the section.
eyebrowbanner_text_colorbanner_eyebrow_colorshow_imageshow_descriptionshow_breadcrumbsbreadcrumbs_labelhome_labelCollection navigation
Enable cross-collection shortcuts and customize their presentation.
show_collection_navnavigation_collectionsLeave blank to not display additional shortcuts to other collections.
show_navigation_imagesnavigation_headingnavigation_labelGrid
Set pagination, number of columns, and grid display controls.
products_per_pageA higher value loads more cards on each page.
Default: 16 · Range: 8–36columns_desktopcolumns_mobileshow_grid_switchergrid_switcher_labelgrid_columns_labelFilters and sorting
Activate the filtering and sorting tools, then adapt their presentation and labels.
enable_filteringenable_sortingfilter_layoutfilter_sidebar_widthfilter_sidebar_stickyfilter_labelfilter_headingsort_labelapply_labelclear_labelclear_all_labelclose_labelminimum_labelmaximum_labelactive_filters_labelProduct cards
Adjust media, variants, purchase actions and sales signals for product cards.
media_limitLimits the number of media loaded per product card.
Default: 2 · Range: 1–5enable_media_slidershow_quick_addshow_quantity_selectorshow_color_swatchesshow_material_badgeshow_low_stockshow_reviewsshow_product_infosinfo_limitenable_size_guidesize_guide_iconlow_stock_thresholdThe low stock alert is displayed when the quantity on hand reaches this threshold.
Default: 5 · Range: 1–20color_option_namesSeparate option names used for colors with commas.
size_option_namesSeparate option names used for sizes with commas.
quick_add_labelconfirm_add_labeladding_labeladded_labelerror_labelsold_out_labelsize_guide_labelsize_guide_textSystem texts
Adapt counters, empty states, error messages and paging commands.
product_count_labelempty_headingempty_textpagination_labelpagination_styleload_more_labelloading_labelload_error_labelprevious_page_labelnext_page_labelSpacing
Adjust the space above and below the section.
padding_toppadding_bottomSection palette
Applies a consistent palette to the background, text, and buttons in this section.
Section appearance
opaline_use_color_schemeopaline_color_schemeSpacing
opaline_section_spacingCreates space between this section and the next. Mobile spacing adjusts automatically.
Default: 0 · Range: 0–160pxopaline_content_insetMoves content away from the edges. Mobile spacing adjusts automatically.
Default: 0 · Range: 0–120pxAvailable blocks
@appAdd this block only when it provides useful information to the journey.
infoAdd this block only when it provides useful information to the journey.
promotionAdd this block only when it provides useful information to the journey.
Before publishing
- ✓
Content remains readable in every color scheme.
- ✓
Labels match the storefront language.
- ✓
Displayed promotions match Shopify rules.
- ✓
Interactions remain accessible by keyboard and touch.