Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
VTEX IO Apps
Product Summary
Official extension
Version: 2.58.2
Latest version: 2.90.7

This page is about version 2.58.2 of the app, which is not the most recent version. The latest stable version is 2.90.7.

{"base64":"  ","img":{"width":110,"height":20,"type":"svg","mime":"image/svg+xml","wUnits":"px","hUnits":"px","url":"https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square"}}

Product Summary is an app responsible for summarizing product information (such as name, price and image) in other store blocks, such as the Shelf and the Minicart.

{"base64":"  ","img":{"width":596,"height":1074,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":177196,"url":"https://user-images.githubusercontent.com/284515/70235170-1a503a80-1741-11ea-952d-07b178995f92.png"}}

Configuration

  1. Import the vtex.product-summary app to your theme's dependencies in the manifest.json:

_10
"dependencies": {
_10
"vtex.product-summary": "2.x"
_10
}

Now, you are able to use all blocks exported by the product-summary app. Check out the full list below:

Block nameDescription
product-summary.shelf
{"base64":"  ","img":{"width":69,"height":20,"type":"svg","mime":"image/svg+xml","wUnits":"px","hUnits":"px","url":"https://img.shields.io/badge/-Mandatory-red"}}
Logical block responsible for providing the needed structure, data and context for its child blocks (listed below).
product-summary-attachment-listRenders a list for the product attachments.
product-summary-brandRenders the product brand.
product-summary-buy-buttonRenders the Buy Button. Notice that this block should only be configured if your store still uses the Minicart v1. When using the Minicart v2, you should configure the Add To Cart Button instead.
product-summary-descriptionRenders the product description.
product-summary-imageRenders the product image.
list-context.product-listRenders a list of products in the Product Summary.
product-summary-nameRenders the product name.
product-summary-priceRenders the product price.
product-summary-sku-selectorRenders the SKU Selector block.
product-specification-badgesRenders badges based on the product specifications.
  1. Add the product-summary.shelf block to the block that will host the product information, such as the Shelf. Notice that although the block's name refers to the Shelf block, it can and should be used in any block that is able to render summarizing product information, such as the Minicart and those found on the Search Results page.

_10
"shelf#home": {
_10
"blocks": [
_10
"product-summary.shelf"
_10
],
_10
}

  1. Then, based on the product information you desire to have rendered, choose which blocks from the exported list above will be sent as the product-summary.shelf children. In a scenario in which we want to display the product name, description, image, price, a SKU selector and then a Buy Button, it would go as follows:

_16
{
_16
"shelf#home": {
_16
"blocks": ["product-summary.shelf"]
_16
},
_16
_16
"product-summary.shelf": {
_16
"children": [
_16
"product-summary-name",
_16
"product-summary-description",
_16
"product-summary-image",
_16
"product-summary-price",
_16
"product-summary-sku-selector",
_16
"product-summary-buy-button"
_16
]
_16
}
_16
}

In order to configure and better understand each of the Product Summary exported blocks, go through their respective documentation in the Docs folder.

Customization

In order to apply CSS customizations in this and other blocks, follow the instructions given in the recipe on Using CSS Handles for store customization.

CSS Handles
aspectRatio
buyButton
buyButtonContainer
clearLink
column
container
containerNormal
containerSmall
containerInline
description
element
image
imageContainer
imagePlaceholder
information
isHidden
nameContainer
priceContainer
quantityStepperContainer
spacer
See also
VTEX App Store
VTEX IO Apps
ProductSummaryPrice
VTEX IO Apps
ProductSummaryName
VTEX IO Apps
ProductSummaryDescription
VTEX IO Apps
ProductSummarySpecificationBadges
VTEX IO Apps
ProductSummarySKUSelector
VTEX IO Apps
ProductSummaryList
VTEX IO Apps
ProductSummaryImage
VTEX IO Apps
ProductSummaryBrand
VTEX IO Apps
ProductSummaryBuyButton
VTEX IO Apps
ProductSummaryAttachmentList
VTEX IO Apps