Edit Category Pages
Open a category in the editor, add a navigation link, and adjust shared category layouts, page size, responsive grids, and image proportions.
Category pages display the products and subcategories assigned to a collection. You can add page content in the website editor and configure the layout used by category pages across your store.
Before you begin, create your products and categories. Add a few products to the category so you can judge the layout with real content.
Open a category directly in the editor
- Open Commerce → Categories in your site's dashboard.
- Select the category you want to work on.
- Save any category changes.
- Open View & Edit → Edit Category Page Content.
You do not need to add a navigation link before opening the category this way. In the editor, Edit Category takes you back to the category's dashboard settings for its name, images, products, subcategories, and search details.
Add a category to your site's navigation
The current editor manages pages and navigation together in the Pages panel.
- Click Pages in the editor toolbar.
- Click the Add Page plus button.
- Choose Category Link.
- Search for the category if necessary and click Select beside it.
- Check the new category entry in the Pages panel and drag it into the desired navigation position.

You can also use a Featured Categories component to help visitors discover collections from another page. Adding a link changes how visitors reach the category; the products assigned to it are managed separately in the dashboard.
Change the shared category layout
With a category open in the editor, click Change Category Layout in the toolbar.
These settings apply to category pages across the store, not just the category you are currently previewing. Check more than one category before publishing a layout change.

The panel includes:
- Layout: choose a layout supported by your theme, such as Grid or Grid with Category Sidebar.
- Page Size: choose how many products appear on each page of the category listing.
- Product Grid Columns: set the number of products in each row for desktop, tablet, and mobile.
- Product Image Aspect Ratio: choose the proportions used for product images at each device size.
- Subcategory Grid Columns: set the number of subcategories shown per row at each device size.
- Subcategory Image Aspect Ratio: control the proportions of subcategory images at each device size.
Scroll within the panel to reach the remaining controls. For a starting point, try three product columns on desktop, two on tablet, and one on mobile, then adjust based on your images and product names. Review image cropping when changing aspect ratios.
Add category page content
Use Add Content and the available page sections to add an introduction, image, or other content to the category page. The category's SEO Description is search metadata; it is not the place to write visible introductory page text.
Manage product and subcategory membership in Commerce → Categories. To display your manual ordering by default, select Featured for the relevant product or category sort in the main Commerce settings.
Preview and publish
Use Desktop View, Tablet View, and Mobile View in the toolbar to inspect the result. Check long product names, image cropping, the category sidebar if enabled, and any subcategory tiles.
Open Preview to review the customer experience. When ready, click Publish, then open the published category page and test its navigation links and pagination. Because the layout controls are shared, also check another category with a different number of products or subcategories.