> For the complete documentation index, see [llms.txt](https://knowledge.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.themeware.design/knowledge-base/tips-and-tricks/image-optimization.md).

# Image optimization

To ensure optimal image quality, we recommend:

1. **Upload images in a suitable size**
   * Use the thumbnail sizes configured in the corresponding folder in Media Manager.
   * Images with **1920x1920px** are a good choice because Shopware often generates a 1920px thumbnail.
   * Alternatively, you can use a smaller format and deactivate the larger thumbnails.
   * If needed, add a custom size as an additional thumbnail size.
   * Use the templates from the [ThemeWare® Utilities](https://service.themeware.design/en/themeware-utilities) for your theme.
2. **Take performance into account**
   * Product images should be neither too small nor unnecessarily large. Choose a size that offers a good balance between image quality and loading time.
   * Product images should be well compressed to keep the file size as small as possible.
3. **Recommended image optimization**
   * **Optimize thumbnails**: Go to Media Manager and adjust the thumbnail sizes to match your shop design, removing any unnecessary formats as necessary. This helps to prevent redundant data and ensures that images are loaded in the optimal size and quality.
   * **Compress images**: Uncompressed images can significantly slow down the loading time of the shop. Use tools like TinyPNG to reduce the file size without any visible loss of quality.
   * **Use modern image formats**: WebP offers significantly better compression than JPG or PNG with the same or even better image quality. Shopware natively supports WebP, making this format recommended for faster loading times and better performance.
   * **Automatic image optimization**: There are extensions in the Shopware Store that automatically optimize images as soon as they are uploaded. These tools take care of compression and conversion to WebP, so no manual processing is required.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://knowledge.themeware.design/knowledge-base/tips-and-tricks/image-optimization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.