Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
Shipping Simulator
vtex.store-components
Version: 3.172.2
Latest version: 3.172.2

The shipping-simulator block estimates the shipping fee based on a zip code input.

{"base64":"  ","img":{"width":2854,"height":1440,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":572087,"url":"https://user-images.githubusercontent.com/52087100/70262606-6ddb7c00-1773-11ea-91af-ededfd27aa95.png"}}

Configuration

  1. Import the vtex.store-components app to your theme's dependencies in the manifest.json file as in the following example:

_10
"dependencies": {
_10
"vtex.store-components": "3.x"
_10
}

  1. Add the shipping-simulator block to any child of the store.product template (Product Details Page template). For example:

_10
"store.product": {
_10
"children": [
_10
"flex-layout.row#product",
_10
]
_10
},
_10
"flex-layout.row#product": {
_10
"children": [
_10
+ "shipping-simulator"
_10
]
_10
},

  1. Then, declare the shipping-simulator block using the props stated in the Props table. For example:

_10
"shipping-simulator": {
_10
"props": {
_10
"skuID": "342"
_10
}
_10
},

Props

Prop nameTypeDescriptionDefault value
pricingModeenumIf the product has gifts or attachments, for example, you can choose whether the shipping information will be grouped (grouped) by shipping type or showing the shipping prices for each of the items individually (individualItems).individualItems
sellerStringID of the product seller.-
shouldUpdateOrderFormBooleanWhether interacting with the simulator should update the shopper's address in their orderForm.true
skuIdStringID of the current product SKU.-

Customization

To apply CSS customizations in this and other blocks, follow the Using CSS handles for store customization guide.

CSS Handles
shippingContainer
shippingContainerLoader
shippingCTA
shippingInputLoader
shippingNoMessage
shippingTable
shippingTableBody
shippingTableCell
shippingTableCellDeliveryEstimate
shippingTableCellDeliveryName
shippingTableCellDeliveryPrice
shippingTableHead
shippingTableHeadDeliveryEstimate
shippingTableHeadDeliveryName
shippingTableHeadDeliveryPrice
shippingTableLabel
shippingTableRadioBtn
shippingTableRow
shippingZipcodeLabel
shippingZipcodeLabelLoader
See also
Vtex.store Components
VTEX IO Apps
VTEX App Store
VTEX IO Apps