TessaroDocumentationTessaro handbook
Section library / Reference

Collection page

Render collection products, filters, sorting and in-grid promotions.

When to use it#

Render collection products, filters, sorting and in-grid promotions.

Set up#

Configure its layout and add optional Collection promotion blocks.

Available from Add section where supported by its template restrictions.

Section settings#

These are schema defaults. Your installed theme or selected preset can use different saved values.

Banner

Show collection banner#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Show collection image#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Show collection title#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Heading size#

Choices: Compact, Editorial.

Control
select
Default
Editorial

Show collection description#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Overlay opacity#

Range: 0–100 %.

Control
range
Default
25

Grid

Products per page#

Range: 8–48 .

Control
range
Default
12

Desktop columns#

Choices: 2, 3, 4, 5, 6.

Control
select
Default
4

Mobile columns#

Choices: 1, 2.

Control
select
Default
2

Show filtering options#

Filter by availability, price, product type, vendor, and variant options.

Control
checkbox
Default
On

Show sort options#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Pagination#

Choices: Pages, Load more button, Infinite scroll.

Control
select
Default
Pages

Colors

Accent color#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#806042

Button background#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#1F1B17

Button text color#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#FFFFFF

Spacing

Margins add space outside the section. Padding adds space inside it.

Margin top (desktop)#

Range: 0–200 px.

Control
range
Default
0

Margin bottom (desktop)#

Range: 0–200 px.

Control
range
Default
0

Padding top (desktop)#

Range: 0–200 px.

Control
range
Default
48

Padding bottom (desktop)#

Range: 0–200 px.

Control
range
Default
48

Margin top (mobile)#

Range: 0–200 px.

Control
range
Default
0

Margin bottom (mobile)#

Range: 0–200 px.

Control
range
Default
0

Padding top (mobile)#

Range: 0–200 px.

Control
range
Default
32

Padding bottom (mobile)#

Range: 0–200 px.

Control
range
Default
32

Blocks#

Add, reorder and configure the supported blocks in the editor. Some block types have an individual limit.

Collection promotion#

Enable promotion#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Show in collections#

Leave empty to use all collections sharing this template.

Control
collection list
Default
Not set

Insert before product#

Counts products on each page, not grid cells. Positions beyond the last product appear at the end. Range: 1–49 .

Control
range
Default
3

Show only on first page#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
On

Show when filters are active#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
Off

Hide on mobile#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
checkbox
Default
Off

Desktop column span#

Limited to the number of columns in the product grid. Range: 1–6 .

Control
range
Default
2

Mobile column span#

Choices: 1, 2.

Control
select
Default
2

Desktop row span#

Choices: 1, 2.

Control
select
Default
1

Minimum height (desktop)#

Range: 160–800 px.

Control
range
Default
320

Minimum height (mobile)#

Range: 120–600 px.

Control
range
Default
240

Connect collection metafields to the image, heading, text, and link using dynamic sources. An empty promotion is hidden.

Image#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
image picker
Default
Not set

Mobile image#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
image picker
Default
Not set

Heading#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
text
Default
Not set

Text#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
richtext
Default
Not set

Button label#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
text
Default
Explore collection

Adjust this control in the theme editor and preview the result in the relevant template.

Control
url
Default
Not set

Heading size#

Choices: Medium, Large.

Control
select
Default
Medium

Text alignment#

Choices: Left, Center, Right.

Control
select
Default
Left

Vertical position#

Choices: Top, Center, Bottom.

Control
select
Default
Bottom

Image darkening#

Range: 0–100 %.

Control
range
Default
35

Background#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#2C2825

Text#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#FFFFFF

Button background#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#FFFFFF

Button text#

Adjust this control in the theme editor and preview the result in the relevant template.

Control
color
Default
#2C2825

Section block limit: 12.

Tessaro documentation · Setup guides and settings reference

Search guides, settings and sections.