Skip to main content

Product Settings

Configure catalog display, inventory rules, customer reviews, and default measurement units. The tab is split into four sub-sections: General, Inventory, Reviews, and Measurements.

Location: Settings > Products

Display

FieldDescriptionDefault
products_per_pageItems shown per catalog page (1 to 100)12
shop_grid_columnsProducts per row on desktop (1 to 6)3
default_product_sortingInitial sort ordermenu_order
enable_ajax_cartAdd to cart without a full page reloadOn
redirect_to_cart_after_addRedirect to the cart page after adding an itemOff
product_type_badges_enabledMulti-select of product types that render a card badge: variable, grouped, subscription, bundleAll four

Sorting options: menu_order, popularity, rating, date, price (low to high), price-desc (high to low).

The settings type also exposes enable_cart_fragments, shop_page_id, cart_page_id, checkout_page_id, and my_account_page_id. These are not surfaced in the React tab today; menu wiring happens through Joomla menu items, see Menu Setup.

Inventory

FieldDescriptionDefault
manage_stockMaster toggle for stock managementOff
show_stock_statusShow availability text on shop pagesOff
low_stock_thresholdStock level that triggers a low-stock label and admin alerts2
out_of_stock_thresholdStock level at which a product is marked unavailable0
hold_stock_minutesReserve stock for unpaid orders for this many minutes (0 disables holds)60
hide_out_of_stock_itemsRemove out-of-stock products from the catalog listingOff
stock_display_formatWhen to show the exact quantity: always, low_stock, or neveralways

The inventory fields beyond the two top toggles only render once manage_stock is enabled.

Reviews

FieldDescriptionDefault
enable_reviewsMaster toggle for product reviewsOff
reviews_require_approvalReviews stay hidden until an admin approves themOff
reviews_require_verified_purchaseOnly customers who placed an order can leave a reviewOff
enable_star_ratingsShow a 1 to 5 star input alongside the review textOff
star_ratings_requiredA star rating is mandatory when star ratings are enabledOff
show_verified_badgeDisplay a "Verified Buyer" badge on qualifying reviewsOff

All review fields after the master toggle render only when enable_reviews is on. star_ratings_required is gated further by enable_star_ratings.

Measurements

FieldDescriptionDefault
weight_unitkg, g, lbs, or ozkg
dimension_unitcm, m, mm, in, or ydcm

Carriers and live-rate shipping plugins use these units when querying rate APIs, so match them to whatever the carrier account expects.