# Hero banner

{% hint style="info" %}
**Note**: This article is work in progress.
{% endhint %}

Der **ThemeWare® "Hero-Banner"** ist ein Banner-Element für deine Erlebniswelten. Du kannst ihn optimal als Trennelement in Boxed und Full-width Layouts einsetzen.

<figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FwtswP1uerxQ8FXAsVslh%2Fimage.png?alt=media&#x26;token=080da4c7-5b1b-48e5-ac47-642d8f5b2c59" alt=""><figcaption><p>ThemeWare® "Hero-Banner"</p></figcaption></figure>

{% hint style="success" %}
**Beta**: Please note that this element is in a testing phase, feel free to test it.
{% endhint %}

{% hint style="info" %}
**Note**: The element is explicitly intended for use in its own CMS block. It is not designed for use in other CMS blocks and therefore cannot be exchanged or placed in other blocks.
{% endhint %}

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

***

## Configure element

You can configure the ThemeWare® "Hero banner" 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 ![](https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2F2PucLINZ7mAqvu1W2yKk%2Ficon-cog.png?alt=media\&token=56e34152-66e8-4707-8c19-3621b8f2448e) "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="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2F5LqnX0zTxAHXJQvDjj1x%2Fimage.png?alt=media&#x26;token=b5962356-eac9-4095-b8c3-c45066233f09" alt=""><figcaption><p>ThemeWare® "Hero-Banner" konfigurieren</p></figcaption></figure>

***

## Configuration

The configuration of the "Hero banner" is quite self-explanatory. The **text**, the **image** and the "**Minimum height**" are mandatory fields. That's all you really need to configure.

### General

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

> **Content (Text)**
>
> In the section "Text" you can enter the **headline** (2), the **text** (3) and the **button text** (4) for the banner. The text is a mandatory field.
>
> **Image**
>
> In the section "Image" you define the background image of the banner. The "Minimum height" is a mandatory field (default: `340px`).
>
> Beta: You can map the category image in layouts of the type "Listing page".
>
> **Link**
>
> In the section "Link" you define the target of the banner when it is clicked.

### Layout

In the "Layout" tab, you can configure the **overlay** (2), the **headline** (3), the **text** (4), the **button** (5), the **scroll behaviour** of the image (1), a **parallax effect** and a **coloured overlay** (1). You can also configure the alignment of the text content.

> **General**
>
> In the section "General" you can configure the general **background colour** (1), the **padding** and the **border radius**.
>
> **Content**
>
> In the "Content" section you can configure the desired **text alignment** and a **text shadow**.
>
> **Headline**
>
> In the "Headline" section you can configure the **font**, the **font weight**, the **text formatting** and the **text colour** of the headline (3).
>
> **Text**
>
> In the "Text" section you can configure the **font**, the **text colour** and **link colours** of the text (4).
>
> **Button**
>
> In the section "Button" you can configure the **button style** (the colour) and determine whether the button (5) should be filled or displayed as an outline button.
>
> **Image**
>
> In the section "Image" you can configure the **attachment** of the image and specify whether a JavaScript managed **parallax effect** should be applied.
>
> **Content overlay**
>
> In the section "Content overlay" you configure the **horizontal alignment** and the **vertical alignment** as well as the **width** (e.g. auto or 90%) and the **maximum width** (e.g. 90% or 740px) of the "Content overlay".
>
> With the configuration "**Apply overlay styling**" you can activate configuration fields for styling the overlay. Here you can set the **background colou**r, select a **background effect**, a **drop shadow** and **rounded corners**.
>
> **Hover**
>
> In the section "Hover" you can configure a **hover effect**.
>
> **Coloured overlay**
>
> In the section "Coloured overlay" a **coloured overlay** (1) can be activated and configured.

<figure><img src="https://3369454551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyzUEL0OiJhd4m6fQWdQe%2Fuploads%2FI0A6aEMz5FTvzDG6aoYQ%2Fcms-element--hero-banner-components.png?alt=media&#x26;token=66a80a47-fd09-4f48-8ac2-f239639b475f" alt=""><figcaption><p>Elements of the "Hero banner"</p></figcaption></figure>

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the HTML tag for the headline.

### Advanced

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

***

## Scroll effects

By being able to fix the image (= background image) you can achieve a simple parallax effect, which creates a certain sense of depth when scrolling the page

### Parallax effect

In addition, you can activate a JavaScript managed parallax effect. This effect is available when the background image is fixed.

If a CMS element with an activated parallax effect is used in a Shopping Experience, an additional JavaScript plugin is loaded which manages the effect.

{% hint style="info" %}
**Note**: As this effect requires the image to fill the entire page, we recommend using large, high-quality images as the page background.
{% endhint %}

{% hint style="warning" %}
**Important**: Parallax effects are not displayed in mobile viewports for performance reasons.
{% endhint %}

***

## **Demo**

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

> Demo will follow\...
