---
title: Configuring banners
related:
  - https://docs.kentico.com/k8/managing-website-content/banners.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

Banners are advertisement of [various sizes](http://en.wikipedia.org/wiki/Web_banner#Standard_sizes) displayed on the site. The Banners application also allows users to monitor statistics, namely impressions (banner views) and clicks. Banners are organized into categories, of which there are two types:

- **Global banner category** - shared across multiple websites.
- **Site banner category** - bound to a particular site and not accessible from the other sites.

The Banners application utilizes the [Web analytics](https://docs.kentico.com/k8/on-line-marketing-features/web-analytics.md) and [Reporting](https://docs.kentico.com/k8/configuring-kentico/working-with-system-reports.md) applications to log and display how many times a particular banner has been shown on a page (number of impressions) and how many times visitors have clicked the banner.

On this page, you can learn about how you can configure [banners](https://docs.kentico.com/k8/managing-website-content/banners.md) on your site. Once banners are placed on the pages where you want to display them and configured, content editors can make use of them. Specifically, you can learn about:

## Adding the Banner rotator web part

To add a banner to a page, you can use the **Banner rotator** web part. The web part offers more settings than the Banner rotator [widget](https://docs.kentico.com/k8/managing-website-content/adding-page-content-through-widgets.md), that is designed to be used by content editors. The Banner rotator widget is limited to the _Category_, _Width_ and _Height_ settings.

The **Banner rotator** displays banners from a specified category. When you place the web part on a page, it renders the value stored in the **Banner content** property of the banner, encapsulated in an _****_ (anchor) element.

#### To place the Banner rotator on your page:

1. Open the **Pages** application.
2. Switch to the **Design** tab.
3. [Place ](https://docs.kentico.com/k8/developing-websites/developing-websites-using-the-portal-engine/using-and-configuring-web-parts.md)the **Banner rotator** web part. A **Web part properties** dialog opens.
4. Adjust the web part properties. Hover over the properties for additional information.

## Displaying banners

When a user requests a page that contains the Banner rotator web part, the web part selects a banner from the specified category and displays it.

The following factors are taken into account when selecting a banner:

- The **Enabled** property of a banner must be true in order for the banner to be selected.
- Current time must be between the **Valid from** and **Valid to** properties' values.
- The **Impressions left** attribute must have a value greater than zero.
- The **Clicks left** attribute has to be greater than zero.

Another parameter that plays part in the process of selecting banners is the **Weight** property. The higher the weight of a banner, the more often that particular banner is selected by the rotator. The number is decimal, which means you can set a new banner between existing ones without changing their values. For example, if you have two banners with values 4 and 5, you can add a new one with weight set to 4.5.
