Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
Banner
vtex.search
Version: 2.4.0
Latest version: 2.17.0

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

A simple banner with that can configured to appear depending on the context of the search.

Configuration

The banner entity is composed by the following fields:

FieldDescription
ActiveIndicates if banner is active or not.
Banner nameField used as an id.
Type bannerIndicates the banner type. It can be HTML or IMAGE.
HTML / Image URLHtml or image to be inserted.
AreaIndicates which area the banner should appear. It is importante when there is multiple banners in the same page.
TermsList of terms for this banner.
PeriodThe period that this banner will be active.
AttributesList of selected attributes for this banner.

Usage

Add the search-banner block to the search-result-layout.desktop or search-result-layout.mobile. For example:


_19
{
_19
"search-result-layout.desktop": {
_19
"children": [
_19
"flex-layout.row#banner-one"
_19
]
_19
},
_19
"search-banner#one": {
_19
"props": {
_19
"area": "one",
_19
"blockClass": "myBanner",
_19
"horizontalAlignment": "center"
_19
}
_19
},
_19
"flex-layout.row#banner-one": {
_19
"children": [
_19
"search-banner#one"
_19
]
_19
}
_19
}

Props

Prop nameTypeDescriptionDefault value
areaStringIdicates the area. It needs to match the area configured in the banner.-
blockClassStringDefines a custom class for the banner div.-
horizontalAlignmentStringDefines the horizontal alignment for the banner."center"

The possible values for horizontalAlignment are:

Values
"left"
"right"
"center"

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
searchBanner
See also
Vtex.search
VTEX IO Apps
VTEX App Store
VTEX IO Apps