Settings Reference

Every setting in the evolve_features namespace, with the default that applies to BigCommerce stores. See Store Settings for how to change one, Analytics & Tags for the evolve_gtm settings, and Branding & Theming for evolve_theme.

These are the settings that take effect on a BigCommerce store, and the defaults shown are the BigCommerce ones. Anything you don't create a metafield for stays at its default.

Two settings gate whole pages

Turning off wishlist or guestBrowseSite blocks the corresponding page, not just the button that leads to it. A shopper who reaches the URL directly gets a not-found response.

Catalog and product pages

Setting	Type	Default	What it does
showPartNumbers	boolean	true	Shows the part number or SKU on product pages and listings
productImageZoom	boolean	true	Enables zoom on product images
productReviewSummary	boolean	true	Shows the star rating summary
productReviews	boolean	true	Shows individual reviews on the product page
productReviewSubmit	text	registered	Who can submit a review: none, registered, all
plpAddToCart	JSON	{"default":true,"search":false,"exceptions":[]}	Add-to-cart buttons on listing pages. default covers category listings, search covers search results, exceptions is a list of category identifiers to invert
openGraph	boolean	true	Emits Open Graph tags so product and category links preview properly when shared. See SEO

Cart and totals

Checkout itself runs on BigCommerce, so these settings cover the cart and who is allowed to shop. See Shopper Accounts & Checkout.

Setting	Type	Default	What it does
guestShopping	boolean	true	Lets a shopper buy without an account
guestBrowseSite	boolean	true	Lets an unauthenticated visitor browse. Turning this off makes the whole storefront sign-in only
guestSeePrices	boolean	true	Shows prices to unauthenticated visitors. Turning it off also removes price from Open Graph tags
hideTaxIfZero	boolean	false	Hides the tax line in order summary totals when it's zero
hideShippingIfZero	boolean	false	Hides the shipping line in order summary totals when it's zero
hideDiscountIfZero	boolean	true	Hides the discount line in order summary totals when it's zero

Lists

Setting	Type	Default	What it does
wishlist	boolean	true	Wishlists for signed-in shoppers

Navigation and site chrome

Setting	Type	Default	What it does
navigationDepth	number	3	How many levels of your BigCommerce category tree appear in the menu
headerBrands	boolean	false	Adds a brands entry to the header navigation
footerBrands	boolean	true	Adds a brands column to the footer
voiceSearch	boolean	true	Microphone in the search box, on browsers that support it
themeDarkModeToggle	boolean	true	Shopper-facing light/dark mode switch
phoneCountries	text	us	Comma-separated country codes offered in phone number fields
phoneDefaultCountry	text	us	Country preselected in phone number fields

Evolve Image Engine

These apply once Evolve Image Engine is enabled on your storefront.

Setting	Type	Default	What it does
evolveImageEngineAllowedImageHosts	text	empty	Extra hostnames Image Engine may fetch product images from, comma-separated. For example, cdn123.bigcommerce.com
evolveImageEngineVtoDefaultType	text	none	Store-wide Virtual Try-On mode: garment, scene, surface, none
evolveImageEngineVtoDefaultGarmentClass	text	none	Default garment class: UPPER_BODY, LOWER_BODY, FOOTWEAR, FULL_BODY, none
evolveImageEngineVtoDefaultMaterialClass	text	none	Default material class: FABRIC, TILE, WOOD, PAINT, WALLPAPER, STONE, none

Integration setup is not a setting

API origins and credentials are not metafields. That covers Image Search, Image Engine, Image Optimization and reCAPTCHA. Part of the reason is security, because anything readable by the storefront through this mechanism is also readable from a shopper's browser, so a metafield can never hold a credential. The rest is simply that it keeps your integration setup in one place instead of two. Ask support to enable an integration. See Settings we manage for you.

If a setting isn't listed here

This page is the complete set of settings that take effect on a BigCommerce store. If you're looking for something that isn't here, whether that's a shopper feature or a piece of behavior you want to change, talk to us. Much of it can be built for you as an advanced customization.

See also

• Store Settings — how to set, change and remove a setting
• Analytics & Tags — the evolve_gtm settings
• Branding & Theming — the evolve_theme settings