> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.themeware.design/additional-features/custom-fields/categories/hero-section.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.