Product Highlight by VTEX Segment

All ContributorsAll Contributors

The Product Highlight by VTEX Segment app allows shoppers to select a Whitelabel Seller available in their region, and it filters the product listing results accordingly. The app also uses a badge to highlight products of Whitelabel Sellers that are available in the shopper's region.

Media PlaceholderMedia Placeholder

Before you start

Before configuring the Product Highlight by VTEX Segment app, make sure to create a collection for each Whitelabel Seller of your store (See Creating Collections Beta for more information). When naming your collection, make sure to use the following naming structure: {sellerId}-{defaultCollectionName}, where the {sellerId} is the sellerId of the Whitelabel Seller and {defaultCollectionName} is the name of the Collection.

Colection NameColection Name


To configure the Product Highlight by VTEX Segment app, you'll need to:

  1. Set up the default configurations of the Product Highlight by VTEX Segment app via the VTEX Admin.
  2. Add the Product Highlight by VTEX Segment to the store theme.

By the end of these steps, you'll have your store products highlighted according to the Whitelabel Seller selected.

Setting up the Product Highlights app

  1. Open the terminal and log in to the desired VTEX account using the VTEX IO CLI.

  2. Install the vtexarg.product-highlight-by-vtex-segment app on your account.

    vtex install vtexarg.product-highlight-by-vtex-segment
  3. Open the VTEX Admin.

  4. Go to Account Settings > Apps > My apps.

  5. Look for the Product Highlight by VTEX Segment app and click on Settings.

    Product Highlight by VTEX SegmentProduct Highlight by VTEX Segment

  6. Fill in the presented fields as in the following:

    • Default Seller Id - Enter the default seller ID to use in cases the shopper's region is not detected (e.g., jumboargentinav692lanus692).
    • Default Collection Name - Enter the name of the collection corresponding to the default seller ID (e.g., leyDeGondolas). This is the {defaultCollectionName} part of the Collection Name (See Before you start for more information).
    • Image Url of Highlight - Enter the URL of the ximage badge that will highlight the products. For example: Image Url of HighlightImage Url of Highlight
  7. Click on Save.

Adding the Product Highlights component to your store theme

  1. Open your store theme in any code editor of your choice.

  2. Open the manifest.json file and add the vtexarg.product-highlight-by-vtex-segment app as a peer dependency of your theme:

    "peerDependencies": {
    +  "vtexarg.product-highlight-by-vtex-segment": "0.x"
  3. Add the product-highlight-by-vtex-segment block to any child of the store.product template (Product Details Page template). For example:

    "store.product": {
        "children": [
    "flex-layout.row#product-main": {
        "children": [
    "flex-layout.col#right-col": {
        "children": [
    +     "product-highlight-by-vtex-segment"

Now, see the Customization section to add custom styles to your component.

After linking your store theme app in a development workspace, you'll be able to select a Whitelabel Seller available in your region from a dropdown menu list.

Select Whitelabel SellerSelect Whitelabel Seller

You'll then be able to see the chosen badge in the product cards of the selected Whitelabel Seller's collection.

Image Url of HighlightImage Url of Highlight


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

CSS Handles

Contributors ✨

Thanks goes to these wonderful people:

This project follows the all-contributors specification. Contributions of any kind are welcome!

Did this page help you?