Categories section

categories.png

1. Purpose

Displays selected product collections as category items, helping customers quickly browse and discover different product groups.

2. Common use cases

3. How to add

Shopify Admin → Online Store → Themes → Customize → Add section → Categories

4. Main blocks

5. Key settings

5.1. Category item

Setting

Description

Collection

Selects the collection to display. This setting is required.

Collection image

Adds a custom image. Leave blank to use the collection image.

Collection title

Adds a custom title. Leave blank to use the collection name.

Collection link

Overrides the default collection URL.

5.2. Collection label

1.png

To display a custom label for a collection:

  1. Go to Settings → Custom data → Collections → Add definition.

  2. Use:

  3. Open the collection and enter the label value.

5.3. Section heading

Setting

Description

Text alignment

Aligns the heading left, center, or right.

Spacing between items

Adjusts spacing between heading blocks.

Margin bottom

Sets the space below the heading.

The heading supports Heading and Text blocks with responsive size, color, visibility, font weight, and letter-spacing settings.

5.4. Static button

Setting

Description

Title item

Sets the button text. The button is hidden when left blank.

Link

Sets the button destination.

5.5. Section layout

Setting

Description

Color scheme

Controls the section colors.

Spacing between items

Adjusts gaps between category items.

Section padding

Controls spacing above and below the section.

Rate padding (mobile)

Controls responsive spacing on mobile.

Custom CSS

Adds styles to this section only.

6. Best practices

7. Common issues

Issue

Solution

Category is not showing

Select a collection in the Category item.

Collection image is missing

Upload a custom image or add an image to the collection.

Category opens the wrong page

Remove or correct the custom Collection link.

Collection label is missing

Create the theme.label metafield and add a value to the collection.

Static button is not showing

Add text to Title item.

Mobile layout looks crowded

Reduce spacing or the number of category items.