> For the complete documentation index, see [llms.txt](https://docs.search.io/developer-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.search.io/developer-documentation/guides/feature-implementation/promotion-banners.md).

# 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](/files/pm2YHWhCuRlRXrXCyM8y)

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.