Shop

Store-wide defaults for the catalogue, the product page, the cart and checkout, and the header mini cart. A block that sets one of these on its own still wins on the page it is placed on.

These settings apply to the whole site, so a change here is visible on every page that uses the feature. Find them under Canvas > Theme Options, in the Shop tab.

The tab sits in the rail on the left of the screen, with its own panel beside it:

The Shop tab of Canvas > Theme Options

Catalogue

This group holds the following settings:

  • Products per PageDefault0

    How many products each catalogue page lists before pagination. Leave it at 0 to follow the store's own count, which is Rows per page multiplied by Products per row under Appearance → Customize → WooCommerce → Product Catalog.

  • PaginationDefaultNumbered

    Choose how shoppers move between catalogue pages. Numbered pagination is what most stores want, because without it a shopper cannot reach anything past the first page.

    ChoicesNumberedNone

  • Product Image ShapeDefaultEmpty

    Pin every catalogue picture to one shape so the cards in a row line up, whatever sizes your product photographs were uploaded at. Follow each picture leaves them at their own proportions.

    ChoicesFollow each picture (empty)SquarePortrait (4:5)Portrait (3:4)Tall (2:3)Landscape (4:3)Landscape (3:2)

  • Fit Pictures To That ShapeDefaultFill and crop

    Choose what happens to a picture whose own proportions differ from the shape above. Fill and crop enlarges it until it covers the card and trims what hangs over; Fit inside shows the whole picture and leaves space at its edges.

    ChoicesFill and cropFit insideShown when Product Image Shape is set

  • Extra ImagesDefaultSlider When Several

    Choose what a card does with a product's extra gallery pictures: reveal the second one on hover, or turn the card picture into a slideshow. Slider when several does both, a slideshow once a product holds two or more gallery pictures and a hover reveal when it holds one.

    ChoicesReveal on HoverImage SliderSlider When Several

  • Card OverlayDefaultBuy and quick view icons

    Choose what appears over a product picture when a shopper hovers it. The icons and the labelled button both add to the cart without leaving the page.

    ChoicesBuy and quick view iconsOne labelled buttonBuy icon on the pictureno overlayNothingthe card is a link only

  • Products per Row on TabletsDefaultEmpty

    Columns from 768 to 991 pixels wide. Automatic keeps the layout of each product grid. The desktop count is the store's Products per row.

    ChoicesAutomatic (empty)1234

  • Products per Row on PhonesDefaultEmpty

    Columns below 768 pixels wide. Automatic shows one column on small phones and two on larger ones.

    ChoicesAutomatic (empty)12

  • Sale BadgeDefaultText

    What the badge on a discounted product says. Percentage shows the discount, such as -25%, using the largest discount for products with options.

    ChoicesTextPercentageHide

  • Sale Badge TextDefaultEmpty

    Leave it empty to keep the badge text each design uses. A block that sets its own badge text keeps it.

    Shown when Sale Badge is "Text"

Product Page

This group holds the following settings:

  • Products Under a ProductDefaultUp-sells (curated on the product)

    Choose which products appear under a product. Related picks them from shared categories and tags, so it works with no setup; Up-sells and Cross-sells show only the products you pick by hand on each product.

    ChoicesRelated (matched by category / tag)Up-sells (curated on the product)Cross-sells (curated on the product)

  • Order ByDefaultCurated Order (as stored on the product)

    Choose the order that strip is shown in. WooCommerce shuffles related products by default, so an unpinned strip is a different strip on every request; anything other than the default pins it.

    ChoicesWooCommerce Default (shuffled)Curated Order (as stored on the product)Sort Order (menu_order)TitleDatePrice

  • LayoutDefaultCarousel

    Lay the strip out as a grid of cards, or as a carousel a shopper slides through.

    ChoicesGridCarousel

  • Product LimitDefault5

    The most products the strip shows, however many match.

  • ColumnsDefault4 Columns

    How many products sit side by side on a wide screen. Narrow screens stack them.

    Choices2 Columns3 Columns4 Columns5 Columns6 ColumnsShown when Layout is "Grid"

  • Add to Cart Without ReloadingDefaultOn

    Add products to the cart without reloading the page, so a shopper stays where they were. If your store is set to redirect to the cart after adding, that setting wins.

  • Confirmation StyleDefaultToast

    Choose whether the confirmation floats over the page and fades, or sits beside the button until the shopper moves on.

    ChoicesToastInline MessageShown when Add to Cart Without Reloading is on

  • Toast PositionDefaultTop Right

    Where on the screen the floating confirmation appears.

    ChoicesTop LeftTop CenterTop RightMiddle LeftMiddle CenterMiddle RightBottom LeftBottom CenterBottom RightShown when Add to Cart Without Reloading is on and Confirmation Style is "Toast"

  • Gallery StyleDefaultSlider with Thumbnails

    Choose how a product's pictures are shown: a main picture with thumbnails under it, one slide at a time, all of them stacked down the column, or a grid that opens in the lightbox.

    ChoicesSlider with ThumbnailsCarousel (one slide at a time)Stacked (all imagesone under another)Masonry grid (lightbox)

  • Sticky Add to CartDefaultOff

    Show a bar with the product and its Add to Cart button at the bottom of the screen once the shopper scrolls past the product's own button.

  • Show the Sticky Bar OnDefaultAll Devices

    ChoicesAll DevicesDesktopPhones and TabletsShown when Sticky Add to Cart is on

Cart and Checkout

This group holds the following settings:

  • Show Returning Customer PromptDefaultOn

    Show a returning customer prompt above the checkout form so a shopper with an account can sign in and have their details filled in. Your WooCommerce account settings still decide whether the prompt is allowed at all.

  • Show Coupon PromptDefaultOn

    Show a coupon prompt above the checkout form so a shopper can redeem a code without leaving the page. It appears only while coupons are enabled in your WooCommerce settings.

  • Suggest Products in the CartDefaultOn

    Suggest related products under the cart, taken from the cross-sells you set on the products already in it. A cart whose products name no cross-sells shows nothing.

  • Suggestion LimitDefault4

    The most suggestions the cart shows, however many the products in it name.

    Shown when Suggest Products in the Cart is on

  • Free Shipping Progress BarDefaultOff

    Show how much more the shopper needs to spend for free shipping. It uses the minimum order amount of the Free Shipping method in the shopper's shipping zone, and stays hidden when no such method is set up.

  • Show the Bar InDefaulta preset list of 2 rows

    ChoicesMini CartCart PageCheckout PageShown when Free Shipping Progress Bar is on

  • Message Before Free ShippingDefaultEmpty

    Use %s where the amount still to spend goes.

    Shown when Free Shipping Progress Bar is on

  • Message Once Shipping Is FreeDefaultEmpty

    Shown when Free Shipping Progress Bar is on

  • Distraction-Free CheckoutDefaultOff

    On the checkout page, replace the site header with just the logo and the footer with a copyright line, so nothing pulls the shopper away while they pay.

  • Header NoteDefaultSecure checkout

    A short note beside the logo on the checkout page. Leave it empty for none.

    Shown when Distraction-Free Checkout is on

Mini Cart

This group holds the following settings:

  • Cart IconDefaultEmpty

    The icon on the cart button in your header, kept whenever the cart refreshes after a shopper adds something. Leave it empty for the shopping bag the theme ships with.

  • Cart HeadingDefaultEmpty

    The heading above the list of items in the cart dropdown. Leave it empty for Shopping Cart.

  • Empty Cart TextDefaultEmpty

    The message a shopper sees in the cart dropdown before they have added anything. Leave it empty for Your cart is empty.

Catalog Mode

This group holds the following settings:

  • Catalog ModeDefaultOff

    Let visitors browse products without buying: Add to Cart buttons, the cart and checkout are removed, and the cart and checkout pages send visitors to the shop. Turn it off to sell again; nothing is deleted.

  • Applies ToDefaultEveryone

    Logged-out visitors only lets signed-in customers keep buying, for example on a wholesale store.

    ChoicesEveryoneLogged-Out VisitorsShown when Catalog Mode is on

  • Hide PricesDefaultOff

    Shown when Catalog Mode is on

  • Enquiry Button LinkDefaultEmpty

    Where the enquiry button on the product page, in place of Add to Cart, takes the visitor: a full address, or a page written as {page:contact}. Leave it empty for no button.

    Shown when Catalog Mode is on

  • Enquiry Button TextDefaultEmpty

    The words on the enquiry button. Leave it empty for Ask about this product.

    Shown when Catalog Mode is on and Enquiry Button Link is set

Was this page helpful?