> For the complete documentation index, see [llms.txt](https://docs.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeware.design/additional-features/custom-fields/categories/hero-section.md).

# Hero section

With this group of category custom fields you can customise the "Hero section" in this category.

<figure><img src="/files/Ahz8LqhosJQsejwS4T9V" alt=""><figcaption><p>Custom fields</p></figcaption></figure>

{% hint style="success" %}
**Tip**: General or global settings can be found in the theme configuration.
{% endhint %}

***

## Custom fields

You can find the "Hero section" custom fields in the respective category:

> Tab "General" ⇒ Block "Custom fields" ⇒ Tab (Set) "Hero section (... Pro)"

<figure><img src="/files/ZewdnambjS7V2hsXbY2d" alt=""><figcaption></figcaption></figure>

### Show Hero section

Select whether you want to display the "Hero section" in this category.

* **inherit from theme configuration**
  * This is the default option. In this case, the theme configuration defines whether the "Hero section" is displayed or not.
* **no**
  * The "Hero section" is not displayed in this category, regardless of the theme configuration settings.
* **yes**
  * The "Hero section" is displayed in this category if you have selected the representation option `show (via custom field)` in the theme configuration.

**Type**: Selection

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section`

### Text

Enter a text for the "Hero section". If you leave this field empty, the category description is displayed. The input field is HTML-capable.

**Type**: Text editor (HTML)

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section_text`

### Pull up next element

Select whether the next HTML element should be pulled up a bit over the "Hero section", or use the option "inherit from theme configuration".

{% hint style="warning" %}
**Beta**: This configuration is in a testing phase, feel free to give it a try.
{% endhint %}

**Type**: Selection

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section_pull_up`

### Background image

Select a custom background image for this category or leave the field empty to display the category image ("Menu settings" → "Display image").

**Recommended image size**: 1920 × 1080 pixels

**Type**: Media selection

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section_background_image`

### Background colour

Select an individual background colour for the coloured overlay of this category or leave the field empty to use the theme configuration.

**Type**: Colour picker

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section_background_color`

### Text colour

Select an individual text colour for this category ("white text", "light text", "dark text" or "black text") or use the option "inherit from theme configuration".

**Type**: Selection

**Technical name**: `twt_{theme}_{edition}_custom_field__category__hero_section_text_coloration`

***

## Screenshot

<figure><img src="/files/2ReexHW7iurX3EYb84I7" alt=""><figcaption></figcaption></figure>

***

## Theme configuration

You can find the general (global) settings in the theme configuration:

> Tab "Extensions" => Block "Hero section (on listing pages)"

***

## Further information

You can find more information about the extension "Hero section" here:

{% content-ref url="/pages/pOr1teA76AycW8MV1rfP" %}
[Hero section](/additional-features/extensions/hero-section.md)
{% endcontent-ref %}