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 |
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

