Category Listing Rules for PrestaShop, per-category products per page and default sort order
Category Listing Rules is a module for PrestaShop stores that gives each category its own opening order and number of products per page. Installation adds a clear rules screen to the store panel, and the first rule is ready after selecting a category and completing one form.
A single store-wide setting rarely suits an entire catalogue. New arrivals need the latest products first, clearance works better from the lowest price, a carefully arranged flagship range follows its chosen position, and a small accessories category is easier to browse when every product appears together.
The module controls the number of products per page, displays a complete category on one page, and orders products by position, name, price, stock, reference, manufacturer, date added or date updated, in either direction. A product preview filters the chosen range and keeps manual arrangement close to the rule.
One rule covers any selected categories and their descendants, while priority gives a precise exception precedence over a broad catalogue rule. Rules also cover brand pages, search results and home-page ranges, with separate conditions for each shop and customer group. Store-wide defaults cover everything left without a rule, and the shopper's own sorting choice remains in force.
The result is stronger first-page merchandising, less repetitive catalogue work, consistent presentation across a multistore setup, and full control without changing the theme.
Summary of what the module offers
Category Listing Rules decides how product ranges open throughout a PrestaShop store: which products lead, how many appear at once, and which rule applies in each catalogue context. The store keeps its existing product cards and navigation, while merchandising decisions live in one dedicated rules screen.
- The overall change: deliberate product order and page size for every important range.
- Per-range control: sorting, manual arrangement, product preview and a complete one-page view.
- Large catalogue management: selected category groups, descendant inheritance and clear priority.
- Audience and store scope: separate rules for shops, customer groups and different product-list contexts.
- Shopper freedom: customer choices and the theme's existing presentation stay intact.
- Setup and upkeep: one rule form, global defaults, on/off controls and a built-in health check.
How does each range receive the right order and page size?
Every rule combines the number of products shown at once with the order in which they appear. Available orders cover position, name, price, stock, reference, manufacturer, date added and date updated, with both directions wherever they make sense. A clearance range therefore opens from the lowest price, new arrivals open from the latest addition, and a replenishment category puts well-stocked products first.
The same screen shows a product preview filtered by name or manufacturer and supports manual arrangement when a curated sequence matters more than an automatic order. Small ranges use the complete one-page view, while a store-wide maximum prevents an unexpectedly large request from producing an unwieldy page.
Before a rule is saved, the chosen category reports how many products it holds and its full path through the catalogue, and a direct link opens that range in the shop. The merchant confirms the right range rather than recognising a mistake later from a customer complaint.
How does one rule manage a large catalogue?
A rule targets one category, any chosen group of categories, or an entire branch with its descendants. That turns a catalogue policy into one setting: every clearance category follows the same price order, while all new-arrival branches share the same page size. A rule reaches subcategories only when you ask it to, so a narrow decision stays narrow.
Exceptions remain precise. An exact category rule takes precedence over an inherited parent rule, the nearest parent wins among inherited matches, and priority settles any remaining overlap. Exactly one rule ends up governing a range, so the result on the storefront is the one written on the form. Each rule also has its own active switch, so a seasonal arrangement is kept for later without affecting the current store.
Which store, audience and product list receives a rule?
Rules are assigned to the shops where they belong, so one multistore installation carries different merchandising for different storefronts. Customer-group conditions give retail visitors, signed-in wholesale buyers and other audiences their own page size and opening order.
The same rules system covers category pages, brand pages, search results and product ranges on the home page. Scope is explicit on every rule, preventing a choice intended for one store, audience or list from appearing in another.
What happens when a shopper changes the order?
A rule decides how a list opens, not how someone is forced to browse it. When a shopper selects another order or another number of products, that choice remains in force as the range is explored. The configured maximum still protects the store from an excessive page size.
The visual side stays with the active theme. Existing product cards, filters, mobile layout and category design remain familiar because the module changes the merchandising decision rather than replacing the storefront presentation. Nothing is copied into template files, so a theme update leaves the rules untouched.
How much work does setup and maintenance require?
Installation creates the rules screen and a separate page for global defaults. A first rule needs a name, its catalogue scope, products per page and the preferred order. Deeper control remains on the same form through inheritance, shop and customer-group conditions, priority, manual arrangement and the active switch.
Global values provide a sensible fallback for every range without its own rule, including a default page size, default order and maximum page size. Rules remain stored if the module is temporarily removed, and settings carried over from an earlier version of the module appear in the new rules screen by themselves.
The rules list carries an internal name for each rule and filters and sorts by category, page size, order, inheritance, priority and state, so a catalogue with dozens of merchandising decisions stays readable. The built-in health check verifies the installation and its rule storage, and repairs what is missing before a catalogue change reaches customers.
-
Referencemprcategorylistingrules
-
In stock2147483647 Items
-
PrestaShop CompatibilityPS 1.7 – 9.x
-
Pricing ModelOne-time Purchase
-
Module TypeFront & Back-office
-
GDPR RelevantNo
-
Business GoalBoost Conversions
-
External Account NeededNo
-
Module ComplexityFeature-Rich Module
-
Customer Journey StageEngage Shoppers
-
Works With PlatformNo External Platform
What customers say about us
Company reviews
5.0
★
★
★
★
★
(4 reviews)
Loading customer reviews...
No product reviews yet
Be the first to share your experience with this module.
Write a Review
Category Listing Rules gives you per-category control over how a category page lists its products, the number of products per page and the default sort order, with inheritance down the category tree, store-wide defaults, and a hard cap. It changes only how products are listed; it never modifies products, categories, prices or stock, and adds no columns to PrestaShop's own tables.
v2.0.0 — 2026-07-05
- ▸Productized the module with declarative
mprclr_ruleandmprclr_rule_shopdatabase schema. - ▸Added a dedicated Rules admin page for category selection, products-per-page, show-all mode, sort order, inheritance, priority, active status, and shop association.
- ▸Added global fallback settings for products per page, default sort order, and maximum products-per-page cap.
- ▸Added rule resolution for exact category matches, inherited parent-category matches, priority, and stable tie-breaking by rule id.
- ▸Added multishop-aware rule storage and lookup.
- ▸Added license, update, support, integrity, and install-integrity Back Office wiring.
- ▸Added v1 JSON rule migration into v2 rule rows during install and upgrade.
- ▸Fixed v2 upgrade behavior so admin tabs are installed during upgrade as well as fresh install.
- ▸Fixed the Configuration page so the form is rendered only once.
v1.1.0 — 2026-07-04
- ▸Changed fresh installs to start with an empty
MPRCLR_RULESJSON map instead of a hardcoded category rule. - ▸Updated README notes to describe rule-less default installation.
v1.0.1 — 2026-07-04
- ▸Added the module logo.
- ▸Guarded category query page-size changes with
setResultsPerPageavailability checks. - ▸Normalized saved JSON rules so only positive category ids and positive page sizes are stored.
- ▸Kept invalid JSON input visible in the form so the admin can correct it.
v1.0.0 — 2026-07-03
- ▸Initial release.
- ▸Added per-category products-per-page overrides through the
MPRCLR_RULESJSON configuration map. - ▸Registered
actionProductSearchProviderRunQueryBeforeto adjust category product-search results per page before the query runs. - ▸Added a simple Back Office configuration form for the JSON rule map.
Have a question about this product?
Our experts are here to help. Ask anything about installation, compatibility, or specifications.
1301
questions
9
categories
2013
building modules since
1.6–9
PrestaShop versions
v2.0.02026-07-04
- Reworked into a complete per-category listing-rules product
- Per-category products-per-page and default sort order, applied on the category listing page
- Subcategory inheritance — the nearest matching parent wins, with a numeric priority tie-break
Loading full changelog...
Works Well With Category Listing Rules
Modules our team genuinely pairs with this one, and exactly why each belongs in the same setup.
Complement
Shoppers narrow a category with facets while Category Listing Rules decides how many products that list shows and in what order, filtering and listing behaviour stay consistent on the same page.
Complement
SEO Revolution shapes how a category page looks to search engines; Category Listing Rules shapes what visitors see when they land on it, a sensible sort and page length for each category.
Complement
The hard per-page cap stops rule-less categories from rendering huge product lists, and Performance Revolution speeds up delivery of whatever the listing does load, smaller pages, served faster.
Loading feature requests...
30 days return right
Easy return - no questions asked
Plug & Play Modules
Install, set up and take profit
Dedicated Support First
Priority Help & Satisfaction Over Sales
You might also like
- New
