Customizing Categories Listing Page

Overview

This video shows how a CSR admin uses the newly introduced categoriesExtension store property to customize the Categories listing page in Merchandiser Admin. The property is added in the store’s Advanced properties, and its JSON shows or hides the action buttons, configures the grid columns, hides fields in the category creation drawer and defines custom actions. The video then compares a store where the extension is not configured with one where it is.

CSR Admin – Action Buttons

Add the categoriesExtension property with the required JSON. The admin can hide the Import action with hideImport, hide the Export action with hideExport, and hide the Create Category button with hideCreateCategory.

CSR Admin – Grid Columns and Drawer Fields

displayCategoryColumns configures the default display columns in the grid, such as Name, Semantic ID, Visible and Status, each with a label, key, type and size. hideFieldsForCreateCategory lists the fields to hide in the category creation drawer, such as categoryName, categoryId, parentCategory and description.

CSR Admin – Custom Actions

The actions property defines custom actions for the category listing, such as a Refresh Products bulk action.

Merchandiser Admin – Categories Listing Before and After

In a store where the extension isn’t configured, the Import and Export buttons remain visible, and the option to create a category is available with all columns. Once the extension is configured, the hidden options are no longer visible to the CSR user, and any custom actions defined become available.

Timeline

  • 00:04 – Overview: Categories extension for the Categories listing page
  • 00:21 – Adding categoriesExtension in the store’s Advanced properties with JSON
  • 00:28 – hideImport: hiding the Import action
  • 00:33 – hideExport, hideCreateCategory and displayCategoryColumns
  • 00:41 – hideFieldsForCreateCategory: hiding fields in the category creation drawer
  • 00:45 – actions: custom actions on the listing page
  • 00:50 – Store without the extension: Import and Export visible
  • 00:56 – Store with the extension: hidden options removed, custom actions available

For more information, see Creating a Category in the Merchandiser Admin Guide and Customizing Extensions in the CSR Admin Guide.

Related videos: Configuring Inventory Actions and Fields and Configuring Store Pricing, which apply the same approach to the Inventory and Prices pages, and Extension‑Based Attribute Configuration, which uses the same Categories extension to control attributes.