Product boxes
Colors
You can configure the background color of the product box.
Products per row
For the listing you can define for each viewport how many products should be displayed in one row.
Products per row (Layouts with sidebar)
You can adjust different settings for layouts with active sidebar, because the available width is smaller by the width of the sidebar.
Products per row (Product slider)
You can set the number of products per line for product sliders in the Settings (1) of aeach product slider element itself (in the shopping experiences). The value for the Minimal width (2) specifies the minimum width of the product box - Javascript is then used to calculate how many elements fit in one row.
If the width of the content is e.g. 1340px, 4 product tiles can be displayed in a row because 1340px / 4 = 335px. With 5 tiles per line, the maximum possible width of a product tile would be 1340px / 5 = 268px and therefore too small.
Basic configuration
With the Border (1) setting the entire product box gets a border in the specified color. Shadow (2) and shadow:hover (3) highlights the product box with a drop shadow in the selected color. Spacer (4) defines a distance between each product box in the listing grid. The setting may differ for mobile devices. The option Discount in % (5) displays the percentage savings in the badge on discount items. Attention animation (6) moves the product box up a few pixels on mouseover. If Mark sold-out products (7) is enabled, sold-out products (stock 0 + clearance sale) will be labeled with a badge.
Example:
Image
With Mouseover Image change (1) you specify whether an alternative article image is displayed when hovering the mouse over it. The theme automatically selects the next closest assigned article image to the cover image from the configuration of the article.
The checkbox background (2) offers the possibility to use the background color configured under General > Product images > Product image background. This way you can control more specifically when the background color should be applied. In the detail page area, there is also such a checkbox for the gallery.
In addition to the product box itself, the product image can also have a border (3) in the defined border color (4).
Layout type big image - max height (5) gives you the possibility to change the height of the image of this product layout. Unlike the other product box layouts, the Big image product layout is not based on our aspect ratio feature of the images and uses the display of fitted item images with a fixed height.
Example:
Image sizes
For displaying the optimal product image thumbnails in the product boxes for the different devices and screen sizes, many factors play a role. These include, for example, the adjustable number of products per line, the adjustable maximum layout width, and the distance between the product boxes. Settings that affect the size of the boxes and thus also the displayed images.
Once the setting Activate custom srcset-sizes (1) has been enabled, the specified image sizes for each viewport in the settings panels below will take effect.
Rating
Choose between different positions of the rating stars with the Rating position (1) configuration and set whether grayed-out stars should be displayed as placeholders if a product does not yet have any reviews.
Stars (default) - shows the classic star rating display. Stars are only shown if ratings are available.
Stars and placeholders - shows the classic star rating display and shows additionally gray placeholder stars when no ratings are available yet.
Rating value - shows one star and the average rating value as a number.
Rating value with filled display - shows one star filled proportionally to the average rating value, along with the average rating value as a number.
The option Show review count (3) displays the number of reviews an article in the listing has.
Example:
Name
In addition to the general settings for color and typography, the number of lines of the product name in the listing can be changed using the Lines (9) option. This can be useful for particularly short or particularly long product names, as the length of the product names is limited by the number of lines displayed to ensure a uniform appearance in the listing.
The option to trim rows can be disabled by disabling the Limit product names lines (8) option.
Description
You can configure the typography of your product description (1-4). The option Short description instead of an abbreviated product description (5) lets you replace the shortened product description with the product’s custom field “Short description.” If the custom field is not filled, the product’s meta description will be used instead. If that is also empty, the description will fall back to using the basic product description again.
Product number
Display the product number in the product listing. By disabling the display of the article number, you can reduce the height of the product boxes, because no space is reserved for this information.
Variant characteristics
By disabling the display of variant features, you can reduce the height of the product box display, as no space is reserved for this information.
Variant Switcher
With the configuration Position (1–2), you can define whether and where the variant switcher is displayed within the product box. You can customize the design of the variant switcher, including the alignment (3), background color (4–5), text color (6–7), and border color (8–9).
With Display title (10), you can define whether the variant group title is displayed (for example, “Size” or “Color”). Cross out non-combinable properties (11) will visually strike out properties/variants that are not available. You can display tooltips (12) that appear when the user hovers over the variant options.
You can define a variant group threshold (13) if not all variant groups should be displayed. For example, your products may have the properties “Color” and “Size”, but you only want to display the color selection in the product boxes.
Likewise, you can set a variant option threshold (14) to limit how many individual options are shown. This is useful if your products have a large number of variants. Excess variant options will be trimmed and displayed, for example, as “+10”.
Examples:
Variant cheapest price
By disabling the display of the cheapest variant price, you can reduce the height of the display of the product boxes, as no space is reserved for this information.
Price unit
By deactivating the display of the basic price, you can reduce the height of the display of the product boxes, as no space is reserved for this information.
Price
You can configure the typography of your product price (1-4).
Delivery information
Activate the Delivery information (1) in listings to display delivery information in the product card in a minimal Appearance (2) or default mode. Adjust the text align to fit to the alignment of the other elements.
Examples:
Product actions
A product can have actions such as adding the item to the shopping cart, the details button for variants and much more.
The display of buy buttons in listings is a standard feature in Shopware and can be activated under Settings > Shop > Products. More information about the buy button:
Background (1): Give the product listing area a custom background color. Alternatively, set the color of the product card here – this can also be specified using a variable like $zen-product-listing-card-bg.
Appearance (2): Product actions can overlay the product image on mouseover, push up the product information or overlay the product price. By default, the actions are always visible below the price.
Appearance (mobile) (3): If product actions are only visible on mouseover, mobile devices interpret the first touch gesture as mouseover event. The first "click" is therefore used to display the product actions - opening the product is therefore only possible with the second "click". You can therefore make a different setting for mobile devices.
Quantity field (4): In addition to the shopping cart button, a quantity field will be displayed.
Display product action button (5): If active, the product action button is displayed in listings, if extended prices or variants do not allow the display of this buy button.
Product action for variants - main product (6): Product action of the variant shown as the main product in the storefront presentation. Details button | Select options button Quickview must be active for 'Select options button'.
Product action for variants - single product (7): Product action of the variant as expanded by property values or as single product with preselected variant in the storefront presentation. Details button | Select options button | Buy button Since it is clear for individual products which variant ends up in the shopping cart, a shopping cart button can also be displayed here.
Quickview must be active for 'Select options button'.
Product action for product with advanced prices (8): Product action of product with advanced prices. Details button | Select options button Since the cheapest price is usually shown in the listing for advanced prices, there can be no shopping cart button here. (No legal advice)
Quickview must be active for 'Select options button'.
Example:
Product actions - Wishlist & quickview
from theme version 5.10.0
The wishlist and quickview buttons are displayed on the product image. You set their appearance separately from the cart actions.
Appearance (1): Choose whether the buttons are always visible or only appear on mouseover (default).
Appearance (mobile) (2): If the buttons only appear on mouseover, the first touch is used to display them on mobile devices. For faster navigation into the product, you can hide the buttons on mobile devices, always show them or inherit the setting from desktop.
Wishlist (3): Activates the wishlist button, if the wishlist function is activated in the Shopware basic settings.
Last updated