The Catalog, Product Variants, and Stock tabs control how products, variants, and stock are presented in the storefront. Open Shop configurations in the Admin Panel to access these settings.
Catalog tab
The Catalog tab contains catalog visibility, sorting, and filtering rules.
Control | What it does | Options / values |
Items per page | This numeric control sets the default number of items returned per page in catalog listing endpoints, including brands, collection sets, and products. | The control accepts a numeric value. |
Show package quantity | This control determines whether the package quantity, meaning the number of items per package, appears on the product card. | The options are Yes and No. |
Show item unit type in shop | This control determines whether the item unit-type label appears across the storefront on the product page and in the cart next to the quantity. | The options are Yes and No. |
ERP image sync mode | This control determines how product images from the ERP in base64 format are synchronized. | The options are Always sync, Skip if any image exists, and Skip if ERP image exists. |
Product Variants tab
The Product Variants tab contains rules for variant child products and their behavior in the catalog and on the product page. Each setting in this section is a radio group.
Control | What it does | Options / values |
Child attributes | This control determines whether variant child products use attributes inherited from the parent, attributes defined on the child, or both. | The options are Parent, Own, and Both. |
Child packages | This control determines whether variant child products use packages inherited from the parent or defined on the child. | The options are Parent and Own. |
Child prices | This control determines whether variant child products use prices inherited from the parent or defined on the child. | The options are Parent and Own. |
Default variant | This control determines whether one child product is treated as the default selection for the parent product. | The options are Yes and No. |
Preselect variant | This control determines whether a child product is preselected, highlighted, or bordered when the parent product page initially loads. | The options are Yes and No. |
Show variant price | This control determines whether product list cards show the default child product price and an Add to cart button or require option selection first. | The options are Yes and No. |
Stock tab
The Stock tab controls how stock is managed, validated, and displayed across the system. Each setting in this section is a radio group.
Control | What it does | Options / values |
Place out of stock last | When enabled, this control places in-stock products before out-of-stock products in product lists while retaining the selected sorting within each group. | It takes effect only when Stock fetch mode is set to Static, because live stock is not stored in the database and cannot be used for sorting. |
Enforce stock validation | When enabled, this control enforces stock validation during cart operations and order processing, including adding or updating cart items, cart recalculation, order restore, and checkout. | If the requested quantity exceeds available stock, the operation is rejected or adjusted according to backend rules. |
Don't show out of stock products | When enabled, this control excludes out-of-stock products from category pages, search results, brand pages, collection sets, and promoted-product sliders. | It takes effect only when Stock fetch mode is set to Static, because live stock is not stored in the database and cannot be used for filtering. |
Notify on stock exceeded | When enabled together with Enforce stock validation, this control shows shoppers an information toast when they try to set a cart quantity above available stock. | It has no effect when Enforce stock validation is disabled. |
Stock fetch mode | This control determines whether the system fetches stock data from the ERP or uses static data from the database. | The options are Live and Static. |
Stock fetch strategy | This control determines whether the frontend requests stock one item at a time or in batches. | The options are Single item and Batch (collection). |
Show stock level | This control determines whether stock level information is displayed for products in the catalog. | The options are Yes and No. |
Notes
Settings on every Shop configuration tab are saved together when you select Save at the bottom of the page.
Selecting Cancel discards unsaved changes.
On the unchanged form, Save is disabled.
Save remains disabled until you make at least one change.
Related

