Skip to main content

Product Listing Page

Summary: The Product Listing Page is ERPNext’s default storefront where customers can browse published Website Items. It supports multiple display layouts, product filtering, and discount-based browsing to improve the online shopping experience.

ERPNext automatically provides a product listing page whenever Website Items are published. Customers can browse all available products by visiting the /all-products route of your website.

Example:
If your website is https://example.com, the product listing page will be available at:https://example.com/all-products

Prerequisite: At least one Website Item must be published before products appear on the listing page.

Available Views

Customers can switch between two different layouts depending on their browsing preference.

Product List View

The List View displays products in a detailed, information-rich format.

Features

  • Displays the product image.
  • Shows the product name.
  • Displays pricing information.
  • Shows the Short Website Description configured in the Website Item.
  • Provides a compact layout suitable for browsing detailed product information.
Tip: Populate the Short Website Description field in the Website Item to provide customers with a quick overview of each product.

Product Grid View

The Grid View presents products in a visually appealing card-based layout.

Features

  • Displays larger product images.
  • Shows product names and prices.
  • Allows customers to browse many products quickly.
  • Provides a clean and modern shopping experience.
Best For: Stores with image-centric products such as fashion, electronics, furniture, cosmetics, or lifestyle products.

Product Actions

Each product card includes quick action buttons for customer interaction.

Note: In the newer Product Listing interface, product actions become visible only when the customer hovers over a product card.

Product Filters

The Product Listing page provides filtering options that help customers quickly locate relevant products.

1. Field Filters

Field Filters are created using standard Item or Website Item fields configured in E-Commerce Settings.

Examples include:

  • Brand
  • Category
  • Manufacturer
  • Item Group
  • Custom Fields
Configuration: Configure Field Filters from E-Commerce Settings → Filters and Categories.

2. Attribute Filters

Attribute Filters allow customers to filter products based on variant attributes.

Common examples include:

  • Color
  • Size
  • Material
  • Storage Capacity
  • RAM
Tip: Attribute Filters are especially useful for products with multiple variants.

3. Discount Filters

Discount Filters are automatically generated from active product discounts.

When Pricing Rules or discounts are applied to Website Items, ERPNext creates discount filters automatically without requiring additional configuration.

Automatic Feature: No manual setup is required for Discount Filters. They appear automatically whenever discounted products are available.

Configuration Source

The Product Listing page obtains its information from:

  • Published Website Items
  • E-Commerce Settings
  • Website Item display settings
  • Website Item pricing
  • Pricing Rules
  • Field Filters
  • Attribute Filters

Typical Customer Browsing Flow

  1. Customer opens the /all-products page.
  2. Chooses either List View or Grid View.
  3. Uses Field, Attribute, or Discount Filters.
  4. Browses matching products.
  5. Opens a product page for detailed information.
  6. Adds products to the cart or wishlist.
  7. Completes checkout.

Key Benefits

  • Ready-to-use online product catalog.
  • Supports both detailed and visual browsing layouts.
  • Advanced filtering for faster product discovery.
  • Automatic discount categorization.
  • Responsive shopping experience.
  • Seamless integration with Website Items and E-Commerce Settings.
Rating: 0 / 5 (0 votes)