Skip to main content

Shop configuration catalog settings

N
Written by Niyaz

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.

Shop configuration Product Variants tab with variant behavior 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

Did this answer your question?