# Image sizes

{% hint style="danger" %} <mark style="color:red;">Theme retirement</mark> Ira is no longer available on the Shopify theme store. **Theme support and updates for current users will end after May 18, 2024**. [Learn more here](/ira/readme/theme-retirement.md).
{% endhint %}

When it comes to image size, there are really two questions: **how many pixels wide** and **how many megabytes**? Answering these questions will help make sure that your images look great and load fast.

But the answer isn't about exact measurements: what matters is that your images are **above a minimum pixel width** and **below a maximum file size**. Shopify and Ira will handle the rest and automatically optimize and re-size your images for your visitor's screen or device.

## Two guidelines

For optimal image sizes, you can follow these two simple guidelines:

1. Use a **minimum pixel width** of **`2500 px`** for optimal quality on all screens.

   > You don't need very large pixel widths for high quality images. In fact, larger pixel widths rarely makes a noticeable difference in quality.
2. Use a **maximum file size** of around **`2 mb`** for optimal loading speed.

   > You don't need to worry if images are a bit over or under the maximum file size.

## Theme image recommendations

The best image size, shape, and orientation will depend on how it's used: background and hero images will need different dimensions than a logo or icon.

Our image guide combines what we've learned about image size, image formats, and best practices for photos. Below you'll find recommendations for choosing and editing images for different sections and uses on you online store.

* [Product images](#product-images)
* [Collection images](#collection-images)
* [Full-width feature images](#full-width-feature-images)
* [Feature block images](#feature-block-images)
* [Logos and icon images](#logos-and-icon-images)

### **Product images**

| Setting        | Description                                                                                                           |
| -------------- | --------------------------------------------------------------------------------------------------------------------- |
| Size           | Min pixel width: 2500 px.                                                                                             |
| Orientation    | Square or Portrait (vertical) — choose one for consistency                                                            |
| Format         | JPG or WEBP                                                                                                           |
| Theme sections | Featured collection, Featured product, Featured products, Complementary products, Recommended products, Product pages |

Product images appear on **Product pages**, **Collection pages**, and **product listings** used in theme sections.

There are no specific required dimensions for product photography. However, we recommend choosing one shape and orientation for all your product images to maintain a uniform appearance in product grids.

Product pages display images added to your product inventory in the Shopify admin. In the theme editor, you can customize the media gallery layout.

**Product listings** (or product grids) appear on **collection pages** and in some **theme sections**. You can customize the aspect ratio and size of all product images in product listing Theme settings.

### Collection images

| Setting        | Description                                  |
| -------------- | -------------------------------------------- |
| Size           | Min pixel width: 2500 px.                    |
| Orientation    | Square or Landscape (horizontal)             |
| Format         | JPG or WEBP                                  |
| Theme sections | Collection list page, Collection page banner |

Collections images are used for **Collection banners** and **collection listings** used in theme sections.

There are no specific required dimensions. We recommend choosing one shape and orientation for all your featured collection images.

In the **Collection banner** settings in the theme editor, you set an Image focal point to define the most important part of you image.

### Full-width feature images

| Setting        | Description                             |
| -------------- | --------------------------------------- |
| Size           | Min width: 2500 pixels                  |
| Orientation    | Landscape (horizontal)                  |
| Format         | JPG or WEBP                             |
| Theme sections | Mosaic grid, Slideshow, Shoppable image |

**Full-width feature images** span the entire section or screen and are often added as section blocks.

Using landscape (horizontal) images can prevent unwanted cropping or needing to scroll down to see the entire image. We recommend avoiding portrait images, which may appear stretched or make customers scroll down to see the whole image.

### Feature block images

| Setting        | Description                                                                                                            |
| -------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Size           | Min width: 1250 pixels, File size: 2 MB (max 20 MB)                                                                    |
| Orientation    | Square or Portrait (Horizontal)                                                                                        |
| Format         | JPG or WEBP                                                                                                            |
| Theme sections | Carousel, Gallery, Image with text, 2 column mosaic grid, 3 column mosaic grid, Testimonials, Text columns with images |

Many sections include feature images with adjustable sizes, layouts, and positions. These sections often best highlight product and editorial photography.

Consider using *Portrait (vertical)* images in the Image with text section and vertical blocks in the Mosaic grid.

### **Logos and icon images**

| Setting        | Description                                     |
| -------------- | ----------------------------------------------- |
| Size           | Pixel width: 50px - 300px, File size: 1 MB      |
| Orientation    | Square or Landscape (Horizontal)                |
| Format         | PNG (Transparent background) or GIF (animation) |
| Theme sections | Footer, Header, Text columns with images        |

You can add your store's **Logo** to the **Header**, among other sections like the **Footer**.

In the **Header** settings, we recommend setting the **Logo max width** to the actual pixel width of your logo image (between **`50px - 100px`**).

If you enable Ira's transparent header, we recommend adding an **alternate logo** with different colors that contrasts with the background color or image.

<br>

***

> **Related links**
>
> [Web-ready photography](/ira/general/image-guide/web-ready-photography.md)\
> [Image file formats](/ira/general/image-guide/file-formats.md)\
> [Theme image settings](/ira/general/image-guide/theme-image-settings.md)


---

# 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://help.fluorescent.co/ira/general/image-guide/image-sizes.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.