# Category teaser (Advanced)

The **ThemeWare® "Category teaser (Advanced)"** automatically displays category data (name and image) from Shopware's category management and links to the respective category. It is the extended variant with a content overlay and more styling options. 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/qI65H8HkW7mYpHhxfoJz" alt=""><figcaption><p>ThemeWare® "Category teaser (Advanced)"</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® "Category teaser (Advanced)" 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/j0oV6HvaMtlny5TJTcM8" alt=""><figcaption><p>Configuring the ThemeWare® "Category teaser (Advanced)"</p></figcaption></figure>

***

## Configuration

The configuration of the "Category teaser (Advanced)" is quite self-explanatory. The **category** is a mandatory field. The category data (name and image) is displayed automatically. Optionally, you can manually override the **title** and the **image**.

### General

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

> **Category**
>
> In the section "Category" you select the desired category. The **name** (2) and **image** (1) of the category are automatically displayed in the teaser. The link automatically points to the selected category.
>
> **Content**
>
> In the section "Content" you can enter the **title** (optional), the **subtitle**, the **badge text** (3) and the **CTA text**. If the title is left empty, the name of the selected category is displayed automatically.
>
> **Image**
>
> In the section "Image" you can optionally set a custom image to be displayed instead of the category image. You also configure the **display mode** (Cover/Contain/Stretch), the **minimum height** (default: `340px`) and the **accessibility** settings (alt text, decorative image).
>
> **Link**
>
> In the section "Link" the link is automatically set from the selected category. You can configure whether the link should open in a **new tab** and whether the **entire teaser should be linked**.

<figure><img src="/files/mniU38Ga5ayFVf713m1i" alt=""><figcaption><p>Elements of the "Category teaser (Advanced)"</p></figcaption></figure>

### Layout

In the tab "Layout" you can configure the **padding**, the **border radius**, the **background colour**, the **badge**, the **title**, the **subtitle**, the **CTA**, the **content overlay**, **image effects**, **hover effects** and a **coloured overlay**.

> **General**
>
> In the section "General" you can configure the **padding**, the **border radius** and the general **background colour**.
>
> **Badge**
>
> In the section "Badge" you can configure the **badge style**, the **badge colours** and the **badge position**.
>
> **Title**
>
> In the section "Title" you can configure the **font**, the **font weight**, the **text transform** and the **text colour** of the title.
>
> **Subtitle**
>
> In the section "Subtitle" you can configure the **font** and the **text colour** of the subtitle.
>
> **CTA**
>
> In the section "CTA" you can configure the **background** (toggle to activate), the **background colour**, the **drop shadow** and the **text colour** of the CTA.
>
> **CTA hover effects**
>
> In the section "CTA hover effects" you can select a **CTA hover effect**: none, arrow slide in, CTA slide in up, arrow and CTA fade in.
>
> **Content overlay**
>
> In the section "Content overlay" you can configure the **background colour**, the **background effect** (backdrop effect), the **vertical alignment**, the **horizontal alignment** and the **full width** (toggle) of the content overlay.
>
> **Image effects**
>
> In the section "Image effects" you can configure various image effects: **blur**, **brightness**, **contrast**, **grayscale**, **opacity**, **saturate** and **scale**.
>
> **Hover effects**
>
> In the section "Hover effects" you can select a **hover effect** (grow, slide-in-down, slide-in-up, hover-reveal) and determine whether the **CTA should only be shown on hover**.
>
> **Coloured overlay**
>
> In the section "Coloured overlay" a **coloured overlay** can be activated and configured. You can configure a **colour**, a **gradient**, the **angle** and a **hover effect** for the coloured overlay.

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the **HTML tag** and the **HTML tag class**.

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

Fields are available for CSS classes of the **element**, the **title**, the **subtitle**, the **badge** and the **CTA**.


---

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