# Hover box

The **ThemeWare® "Hover box"** is independent of its CMS block. You can use the teaser in other CMS blocks too. Just try out different blocks (for example with a different number of columns) to personalise your Shopping Experience.

<figure><img src="/files/DzeLg9ss7KdRgZNnD0OK" alt=""><figcaption><p>ThemeWare® "Hover box"</p></figcaption></figure>

{% hint style="warning" %}
**Important**: This element is only available in the ThemeWare® Pro Edition.
{% endhint %}

***

## Configure element

You can configure the ThemeWare® "Hover box" as follows:

1. Click on the corresponding CMS block (1) to activate the "edit mode"
2. Hover the mouse over the desired CMS element
3. Click on the ![](/files/DbqYtMQUPw13wmi62Oiq) "gear" icon (2) to configure the CMS element
4. The "Element Settings" pop-up will open
5. Make the desired changes
6. Save your changes

You have now configured the CMS element.

<figure><img src="/files/HWw0bb4NkArsWTXcDCXu" alt=""><figcaption><p>Configuring the ThemeWare® "Hover box"</p></figcaption></figure>

***

## Configuration

The configuration of the "hover box" is quite self-explanatory. The **text** and the **image** are mandatory fields. That's all you really need to configure.

### General

In the tab "General" you configure the content of the element.

> **Content**
>
> In the section "Content" you can enter the headline (3) and the text (4) for the teaser. The text is a mandatory field.
>
> **Image**
>
> In the section "Image" you define the background image (1) of the teaser. This is a mandatory field.
>
> **Link**
>
> In the section "Link" you define the target of the teaser when it is clicked.

{% hint style="info" %}
**Note**: The text area is capable of HTML. However, links `<a>` should not be used, as this interferes with the actual linking of the element.
{% endhint %}

### Layout

In the tab "Layout" you can configure the **overlay** (2), the **text** (3, 4) in the overlay and the **hover effect** of the overlay.

> **General**
>
> In the section "General" you can configure the **general background colour** (1).
>
> **Content**
>
> In the "Content" section you can select the desired **text alignment**.
>
> **Headline**
>
> In the "Headline" section you can configure the **font** and **text colour** for both the headline (3).
>
> **Text**
>
> In the "Text" section you can configure the **font** and **text colour** for the text (4).
>
> **Layout**
>
> In the section "Layout" you can configure the **horizontal alignment** and **vertical alignment** of the text.
>
> **Image**
>
> In the section "Image" you can configure the desired horizontal positioning of the image in display mode 'Cover'.
>
> **Content overlay**
>
> In the section "Content overlay" you configure the overlay (2) of the hover box. Here you can configure the **background colour** of the overlay.
>
> **Hover**
>
> In the section "Hover" you can select a **hover effect** for the content / overlay. With the **Invert hover behaviour** option you can invert the hover behaviour, so that the overlay is displayed by default and hidden on hover.

<figure><img src="/files/uc6wSmucrZdxibbvqQFE" alt=""><figcaption><p>Elements of the "Hover box"</p></figcaption></figure>

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the HTML tag for the headline and the "Lazy loading" of the image.

### Advanced

You can select each HTML element of our teasers using the appropriate CSS classes. If you want to use your own CSS classes, you can insert them in the "Advanced" tab.

***

## Data mapping (coming soon)

On category and product pages, the following fields can be dynamically mapped from the current category or product:

* **Image** - e.g. category image or product image
* **Headline** - e.g. category name or product name
* **Text** - e.g. category description or product description

***

## **Demo**

You can find some examples of use in our demo shops:

{% embed url="<https://demo.themeware.design/modern/en/Features/ThemeWare-CMS-elements/Hover-box/>" %}
ThemeWare® Demoshop => Hover box
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.themeware.design/additional-features/cms-extensions/cms-elements/teaser/hover-box.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.