---
title: "Configure the source for catalog images"
slug: "configure-the-source-for-catalog-images"
abstract: "Configure whether the images on the storefront are retrieved from the Sitecore DAM or the Media Library."
---
# Configure the source for catalog images

Media such as images can greatly enhance the impact and usability of a storefront site. Previously, media items were saved in the [Media Library](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-platform/media-items.html). With the introduction of the Sitecore [Digital Asset Management](https://doc.sitecore.com/xp/en/developers/sxa/103/sitecore-experience-accelerator/render-image-fields-using-transformation-settings.html) (DAM) system, you now have the option to retrieve images from either the Media Library or the DAM.

> [!note]
> You can only use DAM as a source for catalog images when you create a custom integration with Sitecore DAM.

The default image source is the Media Library but you can configure the primary image source to be the DAM. You can do this at the site level or you can [configure](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/configure-a-commerce-rendering.html) each individual rendering when inserted on a page item, a page, or a partial design. The site setting and the rendering-level setting are merged (using an OR operation) at runtime. If either one is selected, the images are retrieved from the DAM.

The following diagram illustrates how the rendering, the rendering model, as well as the providers and classes communicate when retrieving the image URL:

![Sequence diagram for product image communication](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/UseDAMStackFlow.png)

The sequence diagram shows the:

- `CatalogProductImageOptions` class - one of the arguments passed to the providers to create the `CatalogProductImage` object or to retrieve the image link.
- `CatalogProductInfoProvider` - used by the repositories to retrieve the product information.
- `CatalogProductImagesProvider` - used by the `CatalogProductInfoProvider`. It contains the logic for retrieving the image from the Media Library or DAM. It also contains the fallback logic.

    > [!note]
    > DAM images are not scaled in SXA Storefront.

The `CatalogProductInfoProvider` and `CatalogProductImagesProvider` are registered along with the `CatalogProductImage` class is in the `Sitecore.Commerce.XA.Foundation.Common.config` file.

> [!note]
> By default, if the product image is not available in the DAM, the image fallback is to retrieve it from the Media Library. You can change this behavior by customizing the `CatalogProductImage` provider.

<details>
<summary><h2>Configure the catalog image source at the site level</h2></summary>

To configure the catalog image source at the site-level:

1. In the Content Editor, go to *sitecore/<tenant>/<site>/Settings/Commerce/Catalog Configuration*.
2. On the **Content** tab, in the **Commerce** section, click the **Use images from the Digital Asset Management system** images check box.

    ![Site level check box for Use images from the DAM](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/UseDAMImagecheckboxSiteLevel.png)

    > [!warning]
    > The site-level setting and the rendering-level setting are merged (using an OR operation) at runtime. If either one is selected, the images are retrieved from the DAM.

3. On the ribbon menu, click **Save** to save your changes.

</details>

<details>
<summary><h2>Configure the catalog image source for a rendering</h2></summary>

To configure the catalog image source for a rendering:

1. In the Experience Editor, click a rendering on the page to select it.
2. On the <rendering> toolbar, click **More, Edit Component Properties**.
3. In the **Control Properties** dialog box, in the **Catalog Images** section, click the **Use images from the Digital Asset Management system** check box.

    ![Use images from the Digital Asset Management system check box](https://doc.sitecore.com/api/markdown-image/xp/en/developers/103/sitecore-experience-commerce/images/UseDAMImagecheckbox.png)

    > [!warning]
    > The site-level setting and the rendering-level setting are merged (using an OR operation) at runtime. If either one is selected, the images are retrieved from the DAM.

4. On the ribbon menu, click **Save** to save your changes.

</details>