# Hero section You can configure the theme extension "Hero section" via the theme configuration. The "Hero section" can be displayed on CMS listing and/or shop pages.

You can also customise the display for each category using a corresponding custom field if you like. If you want, you can also integrate the breadcrumb into the "Hero section". In addition, you can also use an individual image as an alternative to the original category image using The texts and images shown were taken from the category management ("Catalogues" => "Categories") of Shopware. The "**Name**" and the "**Image**" (= Display image) of the corresponding categories are displayed. As an alternative to the original category image, you can also use a custom image via a corresponding custom field. But let's start with the theme configuration. *** ## Configuration ### **Theme configuration** 1. Go to the tab "**Extensions**" 2. Expand the block "**Hero section**" 3. Enable the configuration "**Show 'Hero section'**" 4. Now configure the "Hero section" as you like * For example, you can integrate the breadcrumb. 5. Save your changes after editing ### **Content** 1. Switch via the main navigation to the "**Category managment**" (1) (2) ("Catalogues" => "Categories") 2. Choose the category you want to edit (3) 3. To the right of the category list, the corresponding category now opens in the category editor (4) 4. You are in the tab "**General**" 5. In the block "**General**" you can edit the category name (**Name**). 6. Scroll to the block "**Menu settings**" 7. Here you can edit the category image (**Display image**) 8. Save your changes

*** ## Display options Here you have the following options for listing and shop pages: * don't show * show * show (via custom field) #### don't show This is the default setting. In this case, the "Hero section" will not be displayed on the corresponding page type. #### show If you select the option `show`, the "Hero section" will be displayed on all pages of the corresponding page type. {% hint style="success" %} **Tip**: You can use the custom field to prevent the "Hero section" from being displayed in a category, allowing you to customise selected categories individually. {% endhint %} #### show (via custom field) If you select `show (via custom field)`, the "Hero section" will only be displayed on the corresponding page type if you have configured the custom field to `yes` in the corresponding category.

{% hint style="info" %} **Note**: This article is work in progress. {% endhint %} ## Basic configuration #### Pull up next element ... ## Content configuration #### Text colour ... #### Text alignment ... #### Container width ... #### Content width ... #### Padding top (≥576px) ... #### Padding top (≥992px) ... ## Overlay configuration #### Background colour ... #### Opacity ... ## Background configuration #### Attachment ... #### Parallax effect ... ## Breadcrumb configuration #### Show breadcrumb ... #### Position ... *** ## Custom fields As you probably already know, the theme configuration is always global, i.e. it applies to all pages across your shop. This also applies to the configuration of the "Hero section" However, you can "overwrite" the theme configuration with a selection of custom fields in any categories and, for example, use a different colour for the "Hero section" in a particular category.

For more information on custom fields, see the following article: {% content-ref url="../custom-fields/categories/hero-section" %} [hero-section](https://docs.themeware.design/additional-features/custom-fields/categories/hero-section) {% endcontent-ref %}