Documentation
Feedback
Guides
Storefront Development

Storefront Development
Store Framework
Using components
Rendering a badge on top of a product

To render a badge on top of a Product Summary component, for example, product collection on a Shelf block, you combine the Product Highlights app and Stack Layout.

{"base64":"  ","img":{"width":1854,"height":751,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":392124,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/vtex-io-documentation-rendering-a-badge-0.png"}}

Before you begin

  1. Knowledge of how the Product Summary, Product Highlights, Stack Layout, and Product collections work is required for this recipe. If you have any doubts regarding them, we strongly recommend you access their technical documentation: Product Summary, Product Highlights, Stack Layout and Collections.

  2. Ensure you have already installed VTEX IO CLI on your machine.

  3. Also, make sure you have as a dependency "vtex.product-summary": "2.x" in your theme’s manifest.json.

Step by step

  1. In your theme’s manifest.json file, add the Product Highlights app and Stack Layout as a dependency:


    _10
    “dependencies” : {
    _10
    "vtex.product-highlights": "2.x",
    _10
    "vtex.stack-layout": "0.x”,
    _10
    _10
    }

  2. Open a product template you desire.

  3. Then, add the stack-layout component to the blocks list of the desired template, for example:


    _10
    {
    _10
    "product-summary.shelf": {
    _10
    "children": [
    _10
    "stack-layout#prodsum",
    _10
    ]
    _10
    },
    _10
    ...

  4. In the theme’s template, declare the stack-layout component, and add the "product-summary-image#shelf" and "vtex.product-highlights@2.x:product-highlights#collection" as its children to render the image and the badge, respectivetly.


    _10
    "stack-layout#prodsum": {
    _10
    "children": [
    _10
    "product-summary-image#shelf",
    _10
    "vtex.product-highlights@2.x:product-highlights#collection"
    _10
    ]
    _10
    },

  5. Then declare the props of the children. The first is "product-summary-image#shelf" props, responsible for rendering the product's image.


    _10
    _10
    "product-summary-image#shelf": {
    _10
    "props": {
    _10
    "showBadge": true,
    _10
    "aspectRatio": "1:1",
    _10
    "maxHeight": 300
    _10
    }
    _10
    },

  6. After declare the props and the children of vtex.product-highlights@2.x:product-highlights#collection: product-highlight-wrapper and product-highlight-text.

    The product-highlight-text only renders the text already defined in the Collection page in a store’s Admin. For more information about it, refer to Collections articles and the Product Highlights app


    _19
    _19
    "vtex.product-highlights@2.x:product-highlights#collection": {
    _19
    "props": {
    _19
    "type": "collection"
    _19
    },
    _19
    "children": ["product-highlight-wrapper"]
    _19
    },
    _19
    "product-highlight-wrapper": {
    _19
    "props": {
    _19
    "blockClass": "collection"
    _19
    },
    _19
    "children": ["product-highlight-text"]
    _19
    },
    _19
    "product-highlight-text": {
    _19
    "props": {
    _19
    "message": "{highlightName}"
    _19
    }
    _19
    },
    _19
    ...

Once you have declared the blocks’ props, link the app and see the changes live at the Development workspace you are working.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
See also
Product Summary
VTEX IO Apps
Linking an app
App Development
Workspace
App Development
Stack Layout
VTEX IO Apps
Product Highlights
VTEX IO Apps
Contributors
1
Photo of the contributor
+ 1 contributors
On this page