# Feature

Use this block to add a styled image.

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)
- [Hero](https://bookstack.iconography.co.uk/books/general/page/hero "Hero") (large rotating banners)
- [Parallax](https://bookstack.iconography.co.uk/books/general/page/parallax "Parallax") (an image that sits behind content, adding depth to a page)
- [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-12/scaled-1680-/Vs5image.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-12/Vs5image.png)

## Editing the Block

<p class="callout info">Styling will be applied to this block as part of your website build - this will then remain constant across all pages.</p>

### Content

<table border="1" id="bkmrk-field-purpose-headin" style="border-collapse: collapse; width: 100%; border-width: 1px;"><colgroup><col style="width: 50.0477%;"></col><col style="width: 50.0477%;"></col></colgroup><thead><tr><td>Field</td><td>Purpose</td></tr></thead><tbody><tr><td>Heading</td><td>*Enter a short title - this will be output as a text overlay, on top of the image*</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>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>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>Mobile Width</td><td>*Choose from:*

- *33%*
- *50%*
- *100%*

</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></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>Text underneath</td><td>*Output the text beneath the image, instead of over the image*</td></tr><tr><td>Text central</td><td>*Output the text centrally on the image*</td></tr><tr><td>Do not crop to fit</td><td>*Toggle to retain the aspect ratio of the image uploaded*</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).