BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Product images

A gallery page for product image references, where the media template that builds the URLs of externally hosted product images for Store Commerce is defined and overridden.

Used by
Retail catalog manager, Retail merchandising manager, Retail store manager
Business process
Add or remove products from catalog in Dynamics 365 Commerce
Menu item
RetailProductImage
Main table
RetailImageResource
Show what matters for
PAGE GUIDEWhat the page does and how to use it7 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA gallery page for product image references, where the media template that builds the URLs of externally hosted product images for Store Commerce is defined and overridden.
What you do hereUse this page to define the media template for the Products entity (path, file extension, number of images per product and default image), generate the derived image URLs for Excel, and overwrite them for individual products.
ExampleFor example, give each product five images named after the product number and set the first one as the default image shown in Store Commerce.
Product images page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Steps from Microsoft

  1. Go to Retail and Commerce > Products and categories > Product images.
  2. On the Action Pane, select Define media template; the Entity field shows Products.
  3. On the Media path FastTab, enter the remaining path of the image location below the media base URL.
  4. In the File Extension field, select the expected file name extension.
  5. Select OK.
  6. Select Define media template again and use Generate Image URLs for Excel to check the derived URLs.
  7. Run the Catalog job (1150) from Retail and Commerce IT > Distribution schedule.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
EntityThe entity the media template applies to; Products on this page.Microsoft Learn
Media pathThe part of the image URL after the channel profile's media base URL; may include a LanguageID token.Microsoft Learn
File ExtensionThe file name extension of the image files.Microsoft Learn
Generate Image URLs for ExcelPreviews the URLs derived from the saved template; required before Edit in Excel.Microsoft Learn
Edit in ExcelOpens the image URLs in Excel so that they can be edited, added or removed per product.Microsoft Learn

Test checklist

  1. Check that the store's channel profile has a Media base URL.
  2. On Product images, select Define media template, set the media path, file extension and number of images per product, and select the default image.
  3. On Generate Image URLs for Excel, select Generate and check a URL opens the image (file name based on the product number).
  4. Run the Catalog job (1150) from Distribution schedule.
  5. Open Store Commerce for the store and check the product image is shown.

Source: Microsoft Learn

Solution architect

4Design impact

Can it be undoneReversible: The media template can be changed at any time, but stores see the change only after the Catalog job (1150) runs. Only overwritten image URLs can be deleted; URLs derived from the template always exist while the template does. Microsoft Learn
If you change it laterAny change to the product media template takes effect in stores only after the Catalog job (1150) is run; overwritten product URLs are shown together with the template URLs. Microsoft Learn
Technical architect

5Technical

Menu itemRetailProductImage Checked in Dynamics 365
FormRetailMediaGallery Checked in Dynamics 365
TableRetailImageResourceShown as “RETAILIMAGERESOURCE” in Record infoChecked in Dynamics 365
Who can open itPrivilegesMaintain media management security. RetailMediaMaintainDutiesMaintain media management security. RetailMediaMaintain
3 security rolesRetail catalog manager RetailCatalogManagerRetail merchandising manager RetailMerchandisingManagerRetail store manager RetailStoreManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail store manager RetailStoreManagerRetail merchandising manager RetailMerchandisingManagerRetail catalog manager RetailCatalogManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): Define media template, View referencesChecked in Dynamics 365
Developer

6Developer

Open it by URLhttps://<your-environment>/?mi=RetailProductImage
Table definitionRetailImageResource columns and relations Microsoft data model
Everyone

7Sources