# Teaser

The **ThemeWare® "Teaser"** 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.

The teaser displays an image with a caption bar at the bottom containing a title, subtitle and optionally an arrow icon.

<figure><img src="/files/WB7JNiuWZD0t2LKoHe33" alt=""><figcaption><p>ThemeWare® "Teaser"</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® "Teaser" 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/3FFEbcW3DvR91aAjkAp3" alt=""><figcaption><p>Configuring the ThemeWare® "Teaser"</p></figcaption></figure>

***

## Configuration

The configuration of the "Teaser" is quite self-explanatory. The **title** 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 **title** and the **subtitle** for the teaser. The title is a mandatory field.
>
> **Image**
>
> In the section "Image" you define the **background image** (1) of the teaser. The image is a mandatory field. You can configure the **display mode** (Cover/Contain/Stretch), the **minimum height** (default: `340px`) and the **alignment**.
>
> **Accessibility**
>
> In the section "Accessibility" you can enter an **alt text** for the image and specify whether the image should be treated as a **decorative image**.
>
> **Link**
>
> In the section "Link" you define the target of the teaser when it is clicked. You can specify whether the link should open in a **new tab** and whether the **entire teaser** acts as a link ("Full link").

<figure><img src="/files/EBHggtH6HNUwytKJI6kz" alt=""><figcaption><p>Elements of the "Teaser"</p></figcaption></figure>

### Layout

In the tab "Layout" you can configure the **caption bar** (2), the **title**, the **subtitle**, the **image**, **hover effects** and a **colour overlay**.

> **General**
>
> In the section "General" you can configure the **padding**, the **border radius** and the **background colour**.

{% hint style="info" %}
**Note**: When using the hover effect "Grow", the padding is controlled by the effect.
{% endhint %}

> **Title**
>
> In the section "Title" you can configure the **font family**, the **font weight**, the **text transform** and the **text colour** for the title.
>
> **Subtitle**
>
> In the section "Subtitle" you can configure the **font family** and the **text colour** for the subtitle.
>
> **Caption bar**
>
> In the section "Caption bar" you can configure the **background colour** and the **backdrop effect** of the caption bar.
>
> **Icon**
>
> In the section "Icon" you can select an **arrow icon** that is displayed on the right side of the caption bar.
>
> **Image**
>
> In the section "Image" you can configure the desired horizontal **positioning** of the image in display mode 'Cover'.
>
> **Hover effects**
>
> In the section "Hover effects" you can select a **hover effect** and specify whether the **CTA on hover** should be displayed. The following hover effects are available:
>
> * **Grow** - The padding of the caption bar grows on hover
> * **Fade in** - The caption bar fades in
> * **Fade out** - The caption bar fades out
> * **Slide in up** - The caption bar slides in from below
> * **Slide in down** - The caption bar slides in from above
>
> **Colour overlay**
>
> In the section "Colour overlay" a **colour overlay** can be activated and configured. You can set a **colour**, a **gradient** and the **gradient angle**.

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the **HTML tag** for the title, an **HTML tag class**, the **fetch priority** 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.

In the "Advanced" tab, CSS classes for the **element** and the **caption bar** are available. The **element ID** is also displayed.

***

## 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
* **Title** - e.g. category name or product name


---

# 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/teaser.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.
