# Promotion banners

Banners are images that can be positioned in your search results and link to a URL.

![Preview of a banner in promotion rules](https://1961411626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH7uk7r2cdqH2TWXzeuDD%2Fuploads%2F3Ac7qRIZqZL8gvSJhogC%2FBanner.png?alt=media\&token=5d8d781a-5f01-4c52-9c70-8ce388d25bc7)

Banner information is sent as part of the regular search response and does not require any additional API calls.

If a category page or search query features a banner, the regular [query collection API ](https://dev.search.io/docs/api/#operation/QueryCollection)call returns an array of banners with the following attributes.

```json
"banners": [
    {
    "description": "string",
    "height": 0, // number of vertical grid cells the banner should occupy 
    "width": 0, // number of horizontal grid cells the banner should occupy
    "id": "string",
    "image_url": "string", // the url to the banner image
    "position": 0, // the position at which to inject the banner
    "target_url": "string",
    "text_color": "string",
    "text_position": "TEXT_POSITION_UNSPECIFIED",
    "title": "string"
    }
],
```

Use the above details to render the banner in the correct position in your custom UI.