Product Module

Tip: In this guide, you will check product categories, the default featured product list, and use the recommended products module when you need consistent product image sizes. Estimated time: 8 minutes.

The homepage should quickly show what you sell and which products matter most. Check existing homepage product modules first. Do not delete and rebuild immediately.

Check default modules and backend content first

The default template usually includes Category Showcase and Featured Product List.

If you only need to update product content, edit the default modules first. If you want every product image to display at the same size, use Recommended Products to replace the default Featured Product List.

If you do not have product categories and products yet, go back to Product Categories and Add Products. Without content, homepage modules may be empty.

Find the page first

Path: AllinCMS Workspace site list → Target site → Enter Admin → Themes → Current theme pages → Home or target page

1Enter the target site adminFind the site you want to edit and click Enter Admin

2Open Themes and click PagesClick Pages on the card for the active theme

3Find Home or the target pageFind Home or the page you want to edit in the current theme

Module Order

1Prepare categories and products

2Check existing homepage modules

3Check Category Showcase

4Check default Featured Product List

5Need consistent image sizes?

6Edit the default moduleNo

7Replace with Recommended ProductsYes

8Check Detail Page

9Publish and click frontend

1. Category Showcase

Open Themes -> Pages -> Home -> Design.

First check whether the homepage already has a category showcase. Add one only if it is missing.

Add a category module in either way:

• Ask AI: Add a product category showcase module after the carousel.
• Manual search: Catalog -> Category Showcase.

After adding it, choose categories, columns, and image style in the right properties panel.

For the first round, show only 3 to 4 main categories. Too many categories make the homepage messy.

If images look uneven, check the guide first. Before preparing category covers and product images, read Image Guidelines. Consistent size and ratio make homepage product modules cleaner.

2. Default Featured Product List

Featured Product List is a common module in the default template. It shows key products on the homepage so visitors can see your highlighted products before entering the product page.

If this module already exists in the first round, do not delete it immediately. Check:

• Whether the products are your own products.
• Whether product clicks open detail pages.
• Whether product order matches your priority.
• Whether images are uneven or heavily cropped.

If only the product content is wrong, edit products in Add Products, or adjust sorting in Featured Products.

Do not keep two duplicate product modules

If you replace the default list with Recommended Products, delete or hide the original Featured Product List. Otherwise the homepage will show repeated products.

3. Recommended Products Module

Many customers want every homepage product image to display at the same size. In that case, replace the default Featured Product List with Recommended Products.

Use this replacement when:

• Product card images have different heights.
• You want to show 4 products per row, or more.
• You want a cleaner grid-like product list.
• You want to set Detail Page in the right properties panel.

Add it in either way:

• Ask AI: Add a recommended products module after the product category module.
• Manual search: Catalog -> Recommended Products.

After adding it, check these right-side settings:

Setting	Recommended value
Columns / items per row	Commonly 4, or more if the layout needs it
Product source	Select the products or product collection to show
Image display	Keep product main image ratios consistent
Detail Page	Choose /products

Consistent images start with product main images. The module can make cards cleaner, but the product main images should also be consistent. Use square main images and read Image Guidelines before uploading.

4. Detail Page

Whether you use the default Featured Product List or a new Recommended Products module, the most common mistake is the product detail link.

In the right properties panel, Detail Page must be:

/products

For post modules, choose /posts.

Do not skip Detail Page

If Detail Page is wrong, visitors may see 404 after clicking a product.

5. Check After Publishing

After publishing, check:

• Homepage shows categories and featured products.
• Category click opens /products?category=category-slug.
• Product click opens a product detail page.
• Product image sizes are mostly consistent and not heavily cropped.
• No template/test product appears on the frontend.

Pitfalls

Mistake	Result	How to avoid it
🔴 Detail Page not set	Product click shows 404	Choose /products
🟡 Keeping two product modules	Homepage shows repeated products	Delete or hide the old module when replacing
🟡 Category has no cover	Homepage module looks weak	Upload covers for main categories
🟡 Product image ratios vary	Product list looks messy	Follow Image Guidelines
🔴 No products in backend	Featured product module is empty	Add products before editing the module

Next

• Featured Products: control featured product order.
• Homepage Basics: check product categories and featured products in the full homepage flow.
• Image Guidelines: prepare product image sizes and ratios.