BeyondERP.Newsletter
Menu

Setup step on the Category images page · Retail and Commerce

Set up Category images

Use this page to define the media template for the Category entity (media path and file extension), generate and check the derived image URLs, and overwrite the URL or set the default image for individual categories.

Used by
Retail catalog manager, Retail merchandising manager, Retail store manager
Business process
Manage sales channels
Menu item
RetailCategoryImage
Main table
RetailImageResource
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA gallery page for category image references, where the media template that builds the URLs of externally hosted category images for Store Commerce is defined and overridden.
What you do hereUse this page to define the media template for the Category entity (media path and file extension), generate and check the derived image URLs, and overwrite the URL or set the default image for individual categories.
ExampleFor example, host one image per category named after the category under a Categories folder on your media server, and set it as the default image shown in POS.
Category 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.

Setup steps on this page

Set up Category images

Use this page to define the media template for the Category entity (media path and file extension), generate and check the derived image URLs, and overwrite the URL or set the default image for individual categories.

Steps from Microsoft

  1. Go to Retail and Commerce > Products and categories > Category images.
  2. On the Action Pane, select Define media template; the Entity field shows Category.
  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. Run the Catalog job (1150) from Retail and Commerce IT > Distribution schedule.
  7. Publish the channel so that the category image template reaches the channel database.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
EntityThe entity the media template applies to; Category on this page.Microsoft Learn
Media pathThe part of the image URL after the channel profile's media base URL.Microsoft Learn
File ExtensionThe file name extension of the category image files.Microsoft Learn
Generate Image URLs for ExcelPreviews the derived URLs and is required before using Edit in Excel.Microsoft Learn
Default imageThe one image per category that the channel shows; must be indicated when a URL is provided explicitly.Microsoft Learn

Test checklist

  1. On Category images, select Define media template with Entity Category, enter the media path and file extension.
  2. Select Generate on Generate Image URLs for Excel and check the URL format.
  3. Overwrite one category's URL and mark it as the default image.
  4. Publish the channel, run the Channel job and Catalog job 1150, and check the image in Store Commerce.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Category imagesOne media template for the Category entity (media path and file extension), with a default image marked for any category whose URL you overwriteStore Commerce shows only one image per category. If you provide explicit URLs and don't mark a default, the system chooses which one to send.Changing a category image and not publishing the channel or running the Channel and Catalog (1150) jobs. Stores and sites keep showing the old image.
Solution architect

5Design impact

Can it be undoneReversible: The template and overwrites can be changed at any time; the change reaches stores after the channel is published and the jobs run.
If you change it laterAfter changing a category image association or template, the channel must be published and the channel and catalog jobs run before stores and sites see the change. Microsoft Learn
Technical architect

6Technical

Menu itemRetailCategoryImage 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

7Developer

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

8Sources

To cite this step: RC-PROD-040, Set up Category images. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/RC-PROD-040