# Hero

Use this block to add large rotating banners with linked products.

There are also other blocks which can be used to add images:

- [Image](https://bookstack.iconography.co.uk/books/general/page/image "Image") (simple images)
- [Carousel](https://bookstack.iconography.co.uk/books/general/page/carousel "Carousel") (small images on a swipeable carousel)
- [Parallax](https://bookstack.iconography.co.uk/books/general/page/parallax "Parallax") (an image that sits behind content, adding depth to a page)
- [Feature](https://bookstack.iconography.co.uk/books/general/page/feature "Feature") (a styled image)
- [Multi-Feature](https://bookstack.iconography.co.uk/books/general/page/multi-feature "Multi-Feature") (multiple static images in a single block)
- [Wide Feature](https://bookstack.iconography.co.uk/books/general/page/wide-feature "Wide-Feature") (image with a block of text)

## Appearance

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-11/scaled-1680-/1yQimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-11/1yQimage.png)

## Editing the Block

Each image has an expandable menu, allowing it to be edited individually.

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-12/scaled-1680-/TTyimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-12/TTyimage.png)

Images may be dragged around to resequence them.

### Content

<table border="1" id="bkmrk-field-purpose-headin" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 49.881%;"></col><col style="width: 49.881%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Title</td><td>*Enter a short title - this will be output as a text overlay, on top of the image*</td></tr><tr><td>Link URL</td><td>*Enter a link URL - if populated, this will add a link to the image.* </td></tr><tr><td>Link Text</td><td>*Text to be shown with a button, if a link is set*

*If left blank, the whole image will act as a button*

</td></tr><tr><td>Additional Text</td><td>*Enter some short text - this will be output as a text overlay, on top of the image below the title*</td></tr><tr><td>Related Products</td><td>*Search for Products by name or SKU Code to link them to this hero image*

*They will display below the image*

*If you have multiple images in a Hero Block, the Products will change along with the image*

</td></tr><tr><td>Delete This Image?</td><td>*Use this control to delete an image*</td></tr></tbody></table>

Use the Image dialogue to select images to upload to this block.

### Settings


<table border="1" id="bkmrk-field-purpose-block-" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.053%;"></col><col style="width: 50.053%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Block Width</td><td>*Choose from:*

- *25%*
- *33%*
- *50%*
- *66%*
- *75%*
- *100%*
- *Full Width (set to always be the full width of the user's device)*

</td></tr><tr><td>Visibility</td><td>*Set the block visibility from the list:*

- *Default (both)*
- *Desktop Only*
- *Mobile Only*
- *Hidden (none)*

</td></tr><tr><td>Text Colour</td><td>*Choose from:*

- *Auto (will select a high contrast automatically)*
- *Black*
- *White*

</td></tr><tr><td>Text Position</td><td>*Alter the alignment of the block text:*

- *Left*
- *Central*
- *Right*

</td></tr></tbody></table>

#### Additional Options

These options allow you to auto assign Products to Hero Images, without assigning specific Products.

<table border="1" id="bkmrk-field-purpose-invert" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 49.947%;"></col><col style="width: 49.947%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Include featured products</td><td>*Auto add featured products to the images in this Hero block*</td></tr><tr><td>Include recommended products</td><td>*Auto add recommended products to the images in this Hero block*</td></tr><tr><td>Include sale products</td><td>*Auto add sale products to the images in this Hero block*</td></tr></tbody></table>

### Advanced

#### Padding

Adding padding will insert space within the current block; this will adjust the position of content within the block.

More information is available [here](https://bookstack.iconography.co.uk/books/general/page/padding).

#### Margin

The margin will add additional space around the current block.

More information is available [here](https://bookstack.iconography.co.uk/books/general/page/margin).