Skip to main content

Shop configuration catalog settings

The Catalog, Product Variants, and Stock tabs of the Shop configuration page contain catalog, variant, and stock settings.

N
Written by Niyaz

The Catalog, Product Variants, and Stock tabs of the Shop configuration page contain catalog, variant, and stock settings. Select Shop configurations in the Admin Panel menu, then open the Catalog, Product Variants, or Stock tab. Each of the three tabs has Cancel and Save buttons, and Save starts out disabled.

Catalog tab

Use this tab for catalog visibility, sorting, and filtering rules.

Setting

What it does

Options

Items per page

Sets the default number of items returned per page in catalog listing endpoints such as brands, collection sets, and products.

Number field

Show package quantity

Controls whether the package quantity, meaning the number of items per package, is displayed on the product card.

Yes, No

Show item unit type in shop

Controls whether the item unit-type label is shown next to the quantity across the storefront, on the product page and in the cart. When the label is hidden, shoppers see only the number, for example 1 instead of 1 followed by the unit name, in the cart quantity column and on product cards.

Yes, No

ERP image sync mode

Controls how product images synced from the ERP as base64 are handled. Always sync replaces the image whenever it changes, which is detected by comparing hashes. Skip if any image exists skips the sync when the product already has any image. Skip if ERP image exists skips the sync only when the product already has an ERP-synced image.

Always sync, Skip if any image exists, Skip if ERP image exists

Pack step enforcement

Sets what the server does when a quantity is not a multiple of the product's pack step. Reject refuses the line and names the nearest acceptable quantity, while Round up raises the quantity to the next whole step. A product whose step is empty, zero, or one is never affected, so a shop whose ERP maps no real step sees no change either way.

Reject, Round up

Search sizes by digits only

When enabled, a search containing only digits, with at least six digits, also matches product titles after non-digit characters are ignored. Existing matches on product code, barcode, and title remain available.

Yes, No

Product Variants tab

Use this tab for the rules that govern variant (child) products and how they behave in the catalog and on the product page. Every setting on this tab is a radio group.

Setting

What it does

Options

Child attributes

Defines which attributes variant (child) products use: inherited from the parent, defined on the child, or both.

Parent, Own, Both

Child packages

Defines which packages variant (child) products use: inherited from the parent or defined on the child.

Parent, Own

Child prices

Defines which price variant (child) products use: inherited from the parent or defined on the child.

Parent, Own

Default variant

Controls whether one child product is treated as the default selection for the parent product.

Yes, No

Preselect variant

On the parent product page, controls whether a child product is preselected, shown highlighted with a border, when the page first loads.

Yes, No

Show variant price

On product list cards, controls whether the default child product's price and an Add to cart button are shown, or the shopper must select options first.

Yes, No

Stock tab

Use this tab to control how stock is managed, validated, and displayed across the system. Every setting on this tab is a radio group.

Setting

What it does

Options

Place out of stock last

When enabled, in-stock products are shown before out-of-stock ones in product lists, and the selected sorting still applies within each group. This setting only takes effect when Stock fetch mode is set to Static.

Yes, No

Enforce stock validation

When enabled, the system enforces stock validation across cart operations and order processing: 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. When stock validation is disabled, cart rows retain normal backgrounds and price text instead of out-of-stock highlighting and greyed prices.

Yes, No

Don't show out of stock products

When enabled, out-of-stock products are completely excluded from storefront product lists: category pages, search results, brand pages, collection sets, and promoted-product sliders. The help text limits this setting to Static stock. Snapshot-based filtering also supports live stock; see Notes for its conditions.

Yes, No

Notify on stock exceeded

When enabled together with Enforce stock validation, shoppers see an info toast when they try to set a cart quantity above available stock. It has no effect if Enforce stock validation is disabled. Shoppers see a message in their own language telling them why their quantity was lowered, so the change is never unexplained.

Yes, No

Repeat order: line above stock

Applies to repeat-order lines above available stock when Enforce stock validation is enabled. Clamp, the default, adds as many whole packages as available stock covers and tells the shopper how many were available. Refuse leaves the line out and lists it as out of stock.

Clamp, Refuse

Stock fetch mode

Defines whether the system fetches stock data from the ERP or uses static data from the database. With Live, the product page and cart use live stock; product-list visibility can use a periodically refreshed stock snapshot.

Live, Static

Stock fetch strategy

Defines whether the frontend requests stock per item or in batches.

Single item, Batch (collection)

Show stock level

Controls whether stock level information is displayed for products in the catalog.

Yes, No

Stock tab of Shop configuration with stock validation, repeat-order, fetching, and display controls.

Notes

  • Stock-based ordering does not apply when stock is fetched live. When stock is not fetched live, the stock-based ordering keeps the selected sort inside each group of in-stock and out-of-stock products.

  • With a stock snapshot available and out-of-stock hiding enabled, list visibility follows snapshot quantities, including for anonymous visitors. Visibility can lag behind live stock by the snapshot refresh interval; before the first snapshot, the catalog remains unfiltered. The snapshot-based behavior keeps filter-sidebar counts consistent with the list, replacing the earlier batch-filtering exception.

  • Shoppers see available stock: the ERP quantity minus what other buyers already have in their carts. That is why a product's stock figure can change from one moment to the next.

  • For similar-product lists, the technical contract bases out-of-stock visibility on stock mode rather than the usual visibility setting. The snapshot-based change instead describes these lists as following the visibility setting, so their documented behavior remains inconsistent.

Related

Did this answer your question?