---
title: How do I replace an image?
slug: en/how-do-i-replace-an-image
createdAt: 2025-08-05T14:19:06.528Z
---

Images on a ticket layout, order email, document or webskin are defined in the HTML code of the layout and stored via **Assets**.

# Replacing an image

1\. Go to **Settings** and then to **Assets**.
If your images are stored in a specific folder, open the appropriate folder.

2\. Click on **Upload file** in the top right corner. Select the desired image and upload it.

::Image[]{src="https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-ZFyhRSygKU91IezkcA22Y-20250801-134053.png" size="76" width="565" height="68" position="center" caption="'Upload file' button" alt="Highlight of the 'Upload file' button" showCaption="true"}

:::hint{type="success"}
We recommend giving the file a clear, simple name.
:::

3\. Copy the full file name (including the extension).
If the file is located in a (sub)folder, include the folder names using `/` as separator.
For example: `example.png` or `img/example.png`

4\. Open the layout in which you want to replace the image.
Look for the existing image in the HTML code. It’s indicated by an `<img>` tag with the `src="..."` attribute.

::Image[]{src="https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-au3bt9xW6f3AwtM8QiVv4-20250801-135518.png" size="50" width="265" height="52" position="center" showCaption="false"}

5\. Replace the file name between the quotation marks with the new file name.

::Image[]{src="https://api.archbee.com/api/optimize/tnY7Mf55_e2QgPQDb0pv7-6zYH_9VQaWaYRvdacuPa9-20250801-135804.png" size="50" width="265" height="47" position="center" showCaption="false"}

In the **preview** of the layout, you will now see the updated image.

:::hint{type="warning"}
Make sure the new image has the same dimensions and/or proportions as the original image. This helps avoid unwanted layout shifts.
:::

# Updating the same image in multiple places

Would you like to replace an image (like a logo) everywhere it’s used without editing the HTML code? You can do so as follows:

1. Locate the existing image in the assets.
2. Copy the file name.
3. Upload your new image. Make sure it has **exactly the same extension** as the original (e.g., .png, .jpg...).
4. Delete the original image.
5. Rename the new image so that it has exactly the same name as the original.

All layouts where this image was used will now automatically display the new version.
It’s recommended to double-check all layouts to ensure no layout shifts occurred.

:::hint{type="info"}
Using consistent, descriptive names for all images makes it easier to replace them this way.
:::