# Image

Use this block to add simple images to your page.

There are also other blocks which can be used to add 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)
- [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-/nMhimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-11/nMhimage.png)

## Editing the Block

### 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 block title - this will show above the main content of the block*</td></tr><tr><td>Body Text</td><td>*This is the main content of the block. Use the controls to format your text*

*It will appear as a caption, below 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>Image</td><td>*Use the dialogue to select an image to upload*</td></tr><tr><td>Alt Text</td><td>*Amend the Alt Text for the image*

</td></tr><tr><td>Delete Image</td><td>*Use the tick box to delete an image - you will be asked to confirm your action*</td></tr></tbody></table>

### Settings


<table border="1" id="bkmrk-field-purpose-block-" 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>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>*Set the block width by selecting from the drop down:*

- *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>Heading Position</td><td>*Alter the alignment of the block header:*

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

</td></tr><tr><td>Background Colour</td><td>*Choose a background colour for your image. Choose from recommended colours, or use a colour picker.* </td></tr></tbody></table>

#### Additional Options

<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>Invert Text Colour</td><td>*Toggle to invert the text colour*</td></tr><tr><td>Actual Size</td><td>*Choose to display the image at actual size*</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).