# Images

The grey boxes in the designs are image placeholders. You can replace them with static or dynamic images. We've applied appropriate **responsive settings** depending on the use case.

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1QOn2UBqpEejvW1zy%2F-Mi1YgXHPA9JNh9rbrNi%2FImages.png?alt=media&#x26;token=869832e4-ea48-4f06-b7cf-98b826ff37d6" alt="Image placeholders"></div>

{% hint style="info" %}
If possible, use [Figma](https://figma.com) or any design tool to edit your static images to the initial size and shape of the image placeholder. Then convert your images to [WEBP](https://convertio.co/jpg-webp/) as this will improve performance and SEO. Ideally keep your image size under 250kb if you can.
{% endhint %}

### Examples

This example has a min width of 20 and a **max width of 100**. The image will not stretch any wider than its current form.

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1QOn2UBqpEejvW1zy%2F-Mi1Z8SZpBM5yzmMdjES%2FImages%201.png?alt=media&#x26;token=8c28381b-1a2f-40ba-a686-9efc275f9cd4" alt=""></div>

This example uses **fixed width** to maintain the round shape. If it wasn't fixed width, the round shape would become a pill shape.

![](https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1QOn2UBqpEejvW1zy%2F-Mi1_OcbkeqmayfsKo4b%2FImages%202.png?alt=media\&token=924736d4-9a7a-4587-9bf0-0d288d67d669)

This example uses **keep element proportions as the page is resized**. The image will maintain its shape as the page is expanded and contracted.

![](https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1QOn2UBqpEejvW1zy%2F-Mi1aGpI0Le__Tieromp%2FImages%203.png?alt=media\&token=fae3d14b-3430-42b3-a214-21ae2b94957d)

## Dynamic image processing

Bubble applies **run mode rendering** to dynamic images. Let's explore how applying different options renders different results.

####

### Run mode rendering: **Rescale**

Bubble fits the dynamic image with its original dimensions into the image element.

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1b98mAMhQ9CAggF0F%2F-Mi1bhXPtfJNRVNgjUQn%2FRescale%20editor.png?alt=media&#x26;token=2a1c9ee2-af06-4ba4-a5aa-39d05905b336" alt="Rescale"></div>

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1bjRpA-oQxRtUNJ_A%2F-Mi1diqsAKSAnDFMIV2e%2FRescale.png?alt=media&#x26;token=b0792ab4-9a9f-4389-be9d-a035e9e39b6a" alt="Rescale rendered"></div>

### Run mode rendering: **Zoom**

Bubble zooms into the image element to maintain its original shape. Results can be pixelated.

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1bjRpA-oQxRtUNJ_A%2F-Mi1cih4b6-KnFyySgbu%2FZoom%20editor.png?alt=media&#x26;token=6b07f99d-bee4-4040-ac25-78e25013c94d" alt="Zoom"></div>

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1bjRpA-oQxRtUNJ_A%2F-Mi1e4HEyqvtzlNAyAOJ%2FZoom.png?alt=media&#x26;token=57a41ba9-f54d-4709-a7b7-becc3e615845" alt="Zoom rendered"></div>

####

### Run mode rendering: Stretch + processed with imgix

Bubble uses the builtin imgix plugin to first crop the image and then we use stretch to make sure the element fills the image element. This will usually give the best results ✅

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1bjRpA-oQxRtUNJ_A%2F-Mi1eFRm0MENvfY2cyV2%2FImgix%20editor.png?alt=media&#x26;token=8b528136-bb2f-4b71-a61e-50a329d3a375" alt="Stretch + imgix"></div>

<div align="left"><img src="https://3157777526-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mhc1tyZ6xD7S7XsqE29%2F-Mi1bjRpA-oQxRtUNJ_A%2F-Mi1esseVyOqPgHNm_p_%2FStretch.png?alt=media&#x26;token=4ccc3160-58c2-400e-8ea8-9bfb00b0a701" alt="Stretch + imgix rendered"></div>
