# Replacing product images and video

You can add a maximum of 250 images, 3D models, or videos to a product. 3D models and videos have specific [hosting limits based on your Shopify plan](https://help.shopify.com/en/manual/products/product-media/add-media#video-and-3d-model-hosting-limits). You can also directly scan and build a 3D model directly within the Shopify app on compatible iOS devices with the [3D scanner feature](https://help.shopify.com/en/manual/products/product-media/3d-scanner).

The first media item for each product is known as the featured, or main, media item. The main media item is displayed on collection pages, the cart page, the checkout page, and your home page. You can change your main media item any time.

\
**Add media to your products**

<details>

<summary>Desktop</summary>

1. From your Shopify admin, go to [**Products**](https://admin.shopify.com/products).
2. Click the product that you want to edit.
3. In the **Media** section, add an image, 3D model, or video in one of the following ways:
   * Click **Upload new**, and then select the file that you want to upload.
   * Drag and drop the file that you want to upload into the **Media** section.
   * Click **Select existing** to review and select from your existing media files.
   * To **Add from URL**, click **Select existing**, and then click **Add from URL**.

</details>

<details>

<summary>iPhone</summary>

1.
2.
3.
4. *
   *
   *
   *
   *
   *
5.

</details>

<details>

<summary>Android</summary>

1.
2.
3.
4. *
   *
   *
   *
   *
5.

</details>

### Change your main product media <a href="#change-your-main-product-media" id="change-your-main-product-media"></a>

<details>

<summary>Desktop</summary>

1. From your Shopify admin, go to [**Products**](https://admin.shopify.com/products).
2. Click the product that you want to edit.
3. In the **Media** section, navigate to the media that you want to make your default media, and then drag and drop the image to the first image's place.

</details>

<details>

<summary>iPhone</summary>

1.
2.
3.
4.
5.
6.

</details>

<details>

<summary>Android</summary>

1.
2.
3.
4.
5.
6.

</details>

**Deleting your media**

You can delete your media individually or in bulk.

#### Delete media individually <a href="#delete-media-individually" id="delete-media-individually"></a>

Removing a file from a product won't remove it from your store. In order to delete media from your store, you have to delete it in the file manager in **Content** > [**Files**](https://admin.shopify.com/content/files) in the admin.

<details>

<summary>Desktop</summary>

1. From your Shopify admin, go to [**Products**](https://admin.shopify.com/products).
2. Click the product that you want to edit.
3. In the **Media** section, hover over the media that you want to delete and check the checkbox.
4. Click **Remove**.

</details>

<details>

<summary>iPhone</summary>

1.
2.
3.
4.
5.
6.

</details>

<details>

<summary>Android</summary>

1.
2.
3.
4.
5.
6.
7.

</details>

#### Delete media in bulk <a href="#bulk-delete-media" id="bulk-delete-media"></a>

If any of the selected files are being used elsewhere in your store, then the files are removed only from the product that you're editing. In order to delete media from your store, you have to delete it in the file manager in **Content** > [**Files**](https://admin.shopify.com/content/files) in the admin.

<details>

<summary>Desktop</summary>

1. From your Shopify admin, go to [**Products**](https://admin.shopify.com/products).
2. Click the product that you want to edit.
3. In the **Media** section, select the media that you want to delete using the checkboxes.
4. Click **Click delete files**.
5. Click **Remove**.

</details>

<details>

<summary>iPhone</summary>

1.
2.
3.
4.
5.
6.

</details>

<details>

<summary>Android</summary>

1.
2.
3.
4.
5.
6.

</details>

### Replace files <a href="#replace-files" id="replace-files"></a>

1. From your Shopify admin, go to **Content** > [**Files**](https://admin.shopify.com/content/files).
2. Click the **Replace** icon next to the file name.
3. Select the file that you want to upload.

### Edit files without overwriting the existing file <a href="#edit-files-without-overwriting-the-existing-file" id="edit-files-without-overwriting-the-existing-file"></a>

In the file editor, it's possible to make destructive edits to an image, such as changing the background of an image. To make changes without overwriting an existing file, save the changes as new.

**Steps:**

1. From your Shopify admin, go to **Content** > [**Files**](https://admin.shopify.com/content/files).
2. Select a media file to open the file editor.
3. Make file edits.
4. From the Save dropdown menu, select Save as new.

Saving as new saves the new file to your store's file system and preserves the original image in its original state.

### File storage limits by plan <a href="#file-limits" id="file-limits"></a>

Each Shopify subscription plan has the following file storage limits:

* Shopify Enterprise: 10 TB (terabyte)
* Shopify Plus: 300 GB (gigabyte)
* Advanced: 300 GB (gigabyte)
* Shopify: 300 GB (gigabyte)
* Basic: 100 GB (gigabyte)

**Note**

If you're on the Advanced plan or Shopify Plus plan, then you can contact Shopify Support to request more storage.

### Videos and 3D models <a href="#videos-and-3d-models" id="videos-and-3d-models"></a>

**Note**

3D models and videos can't be used for your product variant media.

You need to do one of the following to display 3D models or videos in your online store:

* Use a [theme that supports 3D models and videos](https://help.shopify.com/en/manual/products/product-media/product-media-types#supported-themes). If you're using an older version of a supported theme, then you might need to update your theme to the newest version to use 3D models and videos.
* Modify your current theme. If you're comfortable reading and editing theme code, then you can learn more about [adding media support to your theme](https://shopify.dev/themes/product-merchandising/media/support-media) and [media UX guidelines](https://shopify.dev/themes/product-merchandising/media/media-ux) in Shopify's developer documentation. If you're not comfortable reading and editing theme code, then you can [hire a Shopify Partner](https://help.shopify.com/en/manual/partner-directory).

#### Video and 3D model hosting limits <a href="#video-and-3d-model-hosting-limits" id="video-and-3d-model-hosting-limits"></a>

There's a limit to the total number of Shopify-hosted videos and 3D models that your store can have across products and the [**Files**](https://www.shopify.com/admin/content/files) page. The 3D limit depends on the Shopify plan that your store is on:

* Starter: 250 files
* Basic: 250 files
* Shopify: 1000 files
* Advanced: 5000 files
* Shopify Plus: Contact a Merchant Success Specialist

**Note**

For all plans, only 250 media files of any type are allowed per product at a time.

### Adding product media by using metafields <a href="#adding-product-media" id="adding-product-media"></a>

If you want to customize the way that product media are displayed in your online store, then you can use [metafields](https://help.shopify.com/en/manual/custom-data/metafields) to create a file reference metafield for your products. File reference metafields support uploading images to display your products, or all other file types for your customers to download. You can display JPEG, PNG, WEBP, SVG, HEIC, or GIF images in metafields on your online store. A metafield can contain only one file at a time.

If you have an [Online Store 2.0](https://help.shopify.com/en/manual/online-store/themes/themes-by-shopify) theme, then you can connect file reference metafields to your theme by using the theme editor. If you're using vintage themes, then you can [edit your theme code](https://help.shopify.com/en/manual/custom-data/metafields/displaying-metafields-on-your-online-store#edit-code-metafields) or hire a [Shopify Partner](https://help.shopify.com/en/manual/partner-directory) to help you.

### Reverting edits to product images <a href="#reverting-image-edits" id="reverting-image-edits"></a>

If you want to revert a change you made to your images using the [media editor](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/media-editor), whether you no longer need a prior crop, resize, or even Shopify Magic edits, then you can revert an image file to its original state using the **Revert to original** button.

**Note**

The **Revert to original** button is available when previewing media that has been previously edited. Clicking this button prompts you to confirm the revert and then returns the file back to its original form. This feature is only available for product media edits added after January 2024.<br>


---

# 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://nutmegstudio-co.gitbook.io/shopify/chapter-1-managing-products/replacing-product-images-and-video.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.