# Image size guidelines

We know how important it is for your store to look polished and consistent. This guide provides recommended image sizes and best practices tailored specifically for the **Hyper theme**, based on its layout system, section settings, and responsive behavior.

Hyper relies heavily on **aspect ratio settings and height controls**, so image preparation should align with those options.

## Recommended image sizes for different sections & blocks

On the **Hyper** theme, we recommend you apply the particular image sizes to different sections as follows:

{% columns fullWidth="false" %}
{% column %}
[#id-1.-banner-with-tabs](#id-1.-banner-with-tabs "mention")

[#id-2.-before-after-image-slider](#id-2.-before-after-image-slider "mention")

[#id-3.-image-with-text-overlay](#id-3.-image-with-text-overlay "mention")

[#id-4.-image-with-text-slider](#id-4.-image-with-text-slider "mention")

[#id-5.-multicolumn](#id-5.-multicolumn "mention")

[#id-6.-scrolling-gallery-images](#id-6.-scrolling-gallery-images "mention")

[#id-7.-slider-with-multicolumn-slide-item-block](#id-7.-slider-with-multicolumn-slide-item-block "mention")
{% endcolumn %}

{% column %}
[#id-8.-slideshow-slideshow-with-product-scrolling-banner](#id-8.-slideshow-slideshow-with-product-scrolling-banner "mention")

[#id-9.-testimonial-layout-card](#id-9.-testimonial-layout-card "mention")

[#id-10.-blog-post-featured-image](#id-10.-blog-post-featured-image "mention")

[#id-11.-collection-banner](#id-11.-collection-banner "mention")

[#id-12.-collection-list-slider-collection-list-collection-list-banner-collection-card-images](#id-12.-collection-list-slider-collection-list-collection-list-banner-collection-card-images "mention")

[#id-13.-collection-tabs](#id-13.-collection-tabs "mention")

[#id-14.-product-images](#id-14.-product-images "mention")
{% endcolumn %}
{% endcolumns %}

### 1. Banner with tabs

**Recommended image sizes:**

* Desktop image: 1920 × 900 px or 2880 × 1100 px

<figure><img src="/files/ufgJm0kvvZiEZ0BaCCFu" alt=""><figcaption></figcaption></figure>

* Mobile image: 600 × 480 px or 750 × 1080 px

<figure><img src="/files/sPfeiGR8d8kHNOqcFRTn" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
We recommend uploading **separate images for desktop and mobile** to ensure the best composition and **avoid unwanted cropping** on smaller screens.
{% endhint %}

{% tabs %}
{% tab title="Desktop height options" %}

<table><thead><tr><th width="230">Option</th><th width="201">Height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to image</td><td>Auto</td><td>Height adapts to the aspect ratio of first image block</td></tr><tr><td>Extra small</td><td>350px</td><td>Cropped to fixed height</td></tr><tr><td>Small</td><td>450px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>550px</td><td>Cropped to fixed height</td></tr><tr><td>Extra medium</td><td>650px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>700px</td><td>Cropped to fixed height</td></tr><tr><td>Extra large</td><td>750px</td><td>Cropped to fixed height</td></tr></tbody></table>
{% endtab %}

{% tab title="Mobile height options" %}

<table><thead><tr><th width="230">Option</th><th width="201">Height</th><th></th></tr></thead><tbody><tr><td>Auto</td><td>Auto</td><td>Inherits the desktop height setting (including ratio or fixed height)</td></tr><tr><td>Small</td><td>300px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>400px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>500px</td><td>Cropped to fixed height</td></tr><tr><td>Extra large</td><td>600px</td><td>Cropped to fixed height</td></tr><tr><td>Adapt to image</td><td>Auto</td><td>Height adapts to the aspect ratio of first image block</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

How it works:

* **Adapt to image:** Preserving the original proportions of your first image block. All other tabs will follow the same aspect ratio as the first image block.
* **Fixed height options:** Selecting a predefined height (e.g., Small, Medium, Large) ensures consistent section height but may crop images depending on their original ratio.

### 2. Before/after image slider

**Recommended image sizes:**

* Desktop image: 1240 × 1000 px

<figure><img src="/files/OU0N43pD69mofJBqm9y8" alt=""><figcaption></figcaption></figure>

* Mobile image: 1240 × 1000 px

<figure><img src="/files/EGjlb8tnwo8Vj649rzVb" alt=""><figcaption></figcaption></figure>

Image height options:

<table><thead><tr><th width="173">Size</th><th width="160">Desktop height</th><th width="167">Mobile height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to image</td><td>Auto</td><td>Auto</td><td>Height adapts to the aspect ratio of first image block</td></tr><tr><td>Small</td><td>420px</td><td>290px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>560px</td><td>360px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>720px</td><td>420px</td><td>Cropped to fixed height</td></tr></tbody></table>

How it works:

* **Adapt to image:** The height of the before/after images will automatically adjust based on the aspect ratio of the first image block.
* **Fixed height options:** Using fixed height options (Small, Medium, Large), images may be cropped depending on their original proportions.

### 3. Image with text overlay

**Recommended image sizes:**

* Desktop image: 2880 × 1000 px or 2680 × 1080 px

<figure><img src="/files/0MkQ0yYvHJX2RgUhOiuP" alt=""><figcaption></figcaption></figure>

* Mobile image: 750 × 900 px or 686 × 940 px

<figure><img src="/files/1SVAu4XdvFnnpTb5lNhU" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Using separate desktop and mobile images is strongly recommended to ensure optimal composition on different screen sizes.
{% endhint %}

{% tabs %}
{% tab title="Desktop height options" %}

<table><thead><tr><th width="230">Option</th><th width="201">Height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to image</td><td>Auto</td><td>Follows the image’s original aspect ratio (no fixed height)</td></tr><tr><td>Extra small</td><td>350px</td><td>Cropped to fixed height</td></tr><tr><td>Small</td><td>450px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>550px</td><td>Cropped to fixed height</td></tr><tr><td>Extra medium</td><td>650px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>700px</td><td>Cropped to fixed height</td></tr><tr><td>Extra large</td><td>750px</td><td>Cropped to fixed height</td></tr></tbody></table>
{% endtab %}

{% tab title="Mobile height options" %}

<table><thead><tr><th width="230">Option</th><th width="201">Height</th><th></th></tr></thead><tbody><tr><td>Auto</td><td>Auto</td><td>Inherits the desktop height setting (including ratio or fixed height)</td></tr><tr><td>Small</td><td>300px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>400px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>500px</td><td>Cropped to fixed height</td></tr><tr><td>Extra large</td><td>600px</td><td>Cropped to fixed height</td></tr><tr><td>Adapt to image</td><td>Auto</td><td>Uses the mobile image’s own aspect ratio (independent from desktop)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

How it works:

* **Adapt to image:** The section height is determined by the image’s aspect ratio. This helps preserve proportions and reduces unexpected cropping.
* **Fixed height options:** Selecting a predefined height (e.g., Small, Medium, Large) ensures consistent section height but may crop images depending on their original ratio.

### 4. Image with text slider

**Recommended image sizes:**

* Desktop image: 1740 × 960 px
* Mobile image: 686 × 514 px

<figure><img src="/files/P9QQVoyiPqHepfMhcZn3" alt=""><figcaption></figcaption></figure>

Image height options:

<table><thead><tr><th width="200">Option</th><th>Desktop height</th><th>Mobile height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to first image</td><td>Auto</td><td>Auto</td><td>Height adapts to the first image ratio</td></tr><tr><td>Small</td><td>540px</td><td>280px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>630px</td><td>340px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>720px</td><td>420px</td><td>Cropped to fixed height</td></tr></tbody></table>

How it works:

* **Adapt to first image:** Preserving the original proportions of your first image slide. All other slides will follow the same aspect ratio as the first image.
* **Small / Medium / Large:** Applying fixed heights, so images may be cropped depending on their ratio.

### 5. Multicolumn

**Recommended image size:** 626 × 626 px

<figure><img src="/files/nWxsIDME4vnaKQ2eNVBb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This section supports flexible image sizes and automatically adapts to the original image ratio.
{% endhint %}

### 6. Scrolling gallery images

**Recommended image size**: 600 × 540 px or 900 x 810 px

<figure><img src="/files/X1LA4YGAerhCAy9tFpzE" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The image ratio in this section is set to **adapt to the first block’s image**. This means all other blocks will follow the same aspect ratio as the first image.
{% endhint %}

### 7. Slider with multicolumn (Slide item block)

**Recommended image sizes**:

* Desktop image: 1332 × 1332 px
* Mobile image: 686 × 900 px

<figure><img src="/files/YhED1YMPGFvmKqwcsbPj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The image ratio in this section is set to **adapt to the first slide item’s image**. This means all other slides will follow the same aspect ratio as the first image.
{% endhint %}

### 8. Slideshow / Slideshow with product / Scrolling banner

For these sections, the Hyper theme provides flexible height options and supports separate images for desktop and mobile to ensure the best visual presentation across devices.

#### Recommended image sizes

* **Desktop image:** 1920 × 900 px or 2680 × 1120 px

{% tabs %}
{% tab title="Slideshow" %}

<figure><img src="/files/e657wbmR9qjEOHDOxxNu" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Slideshow with product" %}

<figure><img src="/files/wn9bdTY56MBmMyHkRAkY" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Scrolling banner" %}

<figure><img src="/files/GVC3QJyGWIx93kcG9hnT" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

* **Mobile image:** 600 × 480 px or 686 × 940 px

{% tabs %}
{% tab title="Slideshow" %}

<figure><img src="/files/LuEX934NsbIX1PJ5h4YW" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Slideshow with product" %}

<figure><img src="/files/J1vCW0e86AFE5xVuubbm" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Scrolling banner" %}

<figure><img src="/files/BRubm5bNOpnWEnqqIr8X" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
We strongly recommend uploading **separate images for desktop and mobile**. If the same image is used, it will be **center-cropped on mobile**, which may cut off important details.
{% endhint %}

#### Slide height options

{% hint style="info" %}
How it works:

* **Adapt to first image:** Preserving the original proportions of your first image slide. All other slides will follow the same aspect ratio as the first image.
* **Small / Medium / Large:** Applying fixed heights, so images may be cropped depending on their ratio.
  {% endhint %}

{% tabs %}
{% tab title="Slideshow / Slideshow with product" %}

<table><thead><tr><th width="200">Option</th><th>Desktop height</th><th>Mobile height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to first image</td><td>Auto</td><td>Auto</td><td>Height adapts to the first image ratio</td></tr><tr><td>Small</td><td>540px</td><td>280px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>630px</td><td>340px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>720px</td><td>420px</td><td>Cropped to fixed height</td></tr></tbody></table>
{% endtab %}

{% tab title="Scrolling banner" %}

<table><thead><tr><th width="200">Option</th><th width="190">Desktop height</th><th>Mobile height</th><th>Behavior</th></tr></thead><tbody><tr><td>Adapt to first image</td><td>Auto</td><td>Auto</td><td>Height adapts to the first image ratio</td></tr><tr><td>Small</td><td>560px</td><td>400px</td><td>Cropped to fixed height</td></tr><tr><td>Medium</td><td>660px</td><td>480px</td><td>Cropped to fixed height</td></tr><tr><td>Large</td><td>760px</td><td>560px</td><td>Cropped to fixed height</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### 9. Testimonial (Layout - Card)

<figure><img src="/files/vmlDKCKhAnhCAv3Nkqg1" alt=""><figcaption></figcaption></figure>

**Recommended image sizes:**

* **Adapt to image:** keeps original ratio (Recommended size: 740 × 940 px)
* **Square (1:1):** 940 × 940 px
* **Portrait (3:4):** 740 × 987 px
* **Landscape (4:3):** 987 × 740 px

{% hint style="info" %}
When **Adapt to image** is selected, card heights automatically align to the tallest image ratio to maintain a consistent layout.

For best results, use images with the same aspect ratio when **Adapt to image** is enabled.
{% endhint %}

### 10. Blog post featured image

{% hint style="success" %}
To set the blog post featured image, go to **Online Store > Blog posts** in your Shopify admin. Then open the post and locate the **Featured image** field on the right-hand side to upload your image.
{% endhint %}

<figure><img src="/files/qZXMkLJnVdPVgM5KyzNr" alt=""><figcaption></figcaption></figure>

On your website, the blog post featured image is displayed in two places:

* **Post’s thumbnail image (Blog listing page):**&#x20;

Displayed in blog cards. The appearance depends on **Theme settings > Blog cards > Image ratio**.

<figure><img src="/files/j8T6pzOgEDzNiMam7FBT" alt=""><figcaption></figcaption></figure>

* **Post’s featured image banner (Blog post page):**&#x20;

Displayed as the main image at the top of the article. This is controlled by the **Image ratio** setting in the blog post template.

<figure><img src="/files/XnOeZH5OrvjZNhoF9XKN" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can choose images with **square, portrait, or landscape ratios** to achieve the best visual result.

The recommended sizes are:

* **Square (1:1)**: at least 2000 x 2000 px
* **Portrait (3:4)**: at least 2000 × 2667 px
* **Landscape (4:3)**: at least 2400 x 1800 px
* You can also use **Adapt to image** to preserve the original image ratio.
  {% endhint %}

### 11. Collection banner

**Recommended image sizes:**

* Desktop image:&#x20;

  * 2680 × 600 px (for image position: Top, Bottom, or Use image as background)

  <figure><img src="/files/uA5JfpxMlbKlQseKVvKj" alt=""><figcaption></figcaption></figure>

  * 1340 × 600 px (for image position: Left or Right)

  <figure><img src="/files/msP0zVcPubC7HYydRSaz" alt=""><figcaption></figcaption></figure>
* Mobile image: 686 × 440 px

<figure><img src="/files/0u2AiS3OweJS5PUZQlP9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Use images with the correct dimensions based on the selected image position.
{% endhint %}

{% tabs %}
{% tab title="Desktop height options" %}

| Option         | Height | Behavior                                                    |
| -------------- | ------ | ----------------------------------------------------------- |
| Adapt to image | Auto   | Follows the image’s original aspect ratio (no fixed height) |
| Extra small    | 300px  | Cropped to fixed height                                     |
| Small          | 450px  | Cropped to fixed height                                     |
| Medium         | 550px  | Cropped to fixed height                                     |
| Extra medium   | 650px  | Cropped to fixed height                                     |
| Large          | 800px  | Cropped to fixed height                                     |
| {% endtab %}   |        |                                                             |

{% tab title="Mobile height options" %}

<table><thead><tr><th width="249">Option</th><th valign="middle">Height</th><th></th></tr></thead><tbody><tr><td>Auto</td><td valign="middle">Extra small: 220 px<br>Small: 337.5 px<br>Medium: 412.5 px<br>Extra medium: 487.5 px<br>Large: 600 px</td><td>Inherits the desktop height setting (including ratio or fixed height)</td></tr><tr><td>Adapt to image</td><td valign="middle">Auto</td><td>Uses the mobile image’s own aspect ratio (independent from desktop)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

How it works:

* **Adapt to image:** The section height is determined by the image’s aspect ratio, preserving its original proportions and minimizing cropping.
* **Fixed height options:** Selecting a predefined height (e.g., Small, Medium, Large) ensures consistent section height but may crop images depending on their original ratio.

### 12. Collection list slider / Collection list / Collection list banner (Collection card images)

Recommended image sizes:

* **Square (1:1)** *(Recommended)*: 1000 × 1000 px
* **Portrait (3:4)**: 1000 × 1333 px
* **Landscape (4:3)**: 1333 × 1000 px
* **Adapt to image**: keeps original ratio (may look inconsistent)

<figure><img src="/files/9Qu9SYOdT1elvFu6mrud" alt=""><figcaption></figcaption></figure>

### 13. Collection tabs

**Recommended image sizes:**

* **Adapt to image:** keeps original ratio (Recommended size: 1240 × 1274 px)
* **Square (1:1):** 1240 × 1240 px
* **Portrait (3:4):** 1240 × 1653 px
* **Landscape (4:3):** 1240 × 930 px

<figure><img src="/files/IVQDKdSOs1iIfl63i23y" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
When **Adapt to image** is selected, the image ratio of all collection images will follow the ratio of the **first collection block image**.
{% endhint %}

### 14. Product images

From the **Products** tab in your Shopify admin, you can easily add new products along with their images. These products will automatically appear across product-related sections in your Hyper theme, such as *Featured Collection, Multiple Product Bundles, Favorite Products, Product Bundles, Bundle Selection,* and *Recently Viewed Products.*

<figure><img src="/files/eEUBdNjNwv2SA8Nid1P9" alt=""><figcaption></figcaption></figure>

Within Theme settings or individual section settings, you can also control how product images are displayed. Available image ratio options include:

* **Adapt to image**
* **Square**
* **Portrait**
* **Landscape**

These settings allow you to present your product images in the format that best fits your store’s design.

<figure><img src="/files/oVzeVYqUW2vp5fRozsxQ" alt=""><figcaption></figcaption></figure>

For optimal display quality on the Hyper theme, we recommend the following image sizes:

* **Square (1:1)**: at least 2000 x 2000 px
* **Portrait (3:4)**: at least 2000 × 2667 px
* **Landscape (4:3)**: at least 2400 x 1800 px

These are general recommendations to ensure your images look sharp and consistent across all sections.

## Best practices

To ensure a clean, consistent, and professional storefront, we recommend following these guidelines:

* **Maintain consistency:** Use the same image dimensions and aspect ratio within each section for a uniform layout.
* **“Adapt to first image”:** When enabled, the first image defines the layout ratio. Ensure it has the correct proportions.
* **Prepare images properly:** Design images based on the selected ratio settings to avoid unexpected cropping.
* **Desktop & mobile images:** Upload separate versions when possible for better control across screen sizes.
* **High-resolution images:** Use images at approximately 2× the recommended size for sharp display on high-density screens.
* **Avoid mixing ratios:** Different aspect ratios in one section can create uneven layouts.
* **Safe viewing area:** Keep key content (text, focal points) centered to prevent cropping.
* **Slides & galleries:** Keep image sizes and ratios consistent for visual balance.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/hyper-theme/faqs/image-size-guidelines.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.