Skip to main content

Product Module

The page designer has two common product modules: category showcase and recommended products. For a new site's home page, use at least one category module and one recommended-products module.

Add a category showcase​

Open:

Theme -> Pages -> Home -> Design

Two ways to add the category module in the designer:

  • Tell the AI chat: Add a product category showcase module after the carousel.
  • Find it manually: Catalog -> Category Showcase, then drag it onto the page.

After adding, set the categories to show, items per row, and image style in the right-hand properties.

AllinCMS designer category module - the Category Showcase module under Catalog, used to show product category entries on the home page

AllinCMS category showcase properties - the right panel adjusts category source, items per row, and image style

Use Recommended Products instead of the default featured-products list. The default one-large-two-small layout doesn't suit every industry; the recommended module gives you more control.

How to add:

  • Tell the AI chat: Add a recommended products module after the category module.
  • Find it manually: Catalog -> Recommended Products.

AllinCMS recommended products module - the Recommended Products module under Catalog, used to show key products on the home page

You must set the Detail Page​

The most common mistake in the recommended-products module is the detail-page link. The Detail Page in the right panel must be set to:

/products

If this is wrong, clicking a product likely opens a 404.

Same for the article module: set the article detail page to /posts.

AllinCMS recommended detail page setting - Detail Page is set to /products in the right panel, used to ensure a product click reaches the correct detail page

How to confirm success​

After publishing, check the front end:

  • The home page shows categories and recommended products.
  • Clicking a category opens /products?category=<slug>.
  • Clicking a product opens its detail page, not a 404.
  • Image ratios look right, with no heavy cropping.