How to add Custom Layout Update in Magento 2.3+

The Custom Layout Update field on the CMS Page Edit, Category Edit, and Product Edit pages has been converted to a selector, in Magento starting version 2.3.4 to enhance security. You can no longer specify an entity-specific layout update with text but instead must create a physical file that contains the layout updates and select it for use. 

From now on, to add changes to layout on specific page or category you need to create a file and place it in the module or theme folder, e.g.: app/design/frontend/ <Vendor>/<Theme> /<Locale>/layout. After that you will be able to choose it from the list in Custom Layout Update select.

If you already had Layout Updates on the previous Magento versions, you will see Use existing option. So your previous layout changes were saved, and you still can use them but not change. If you’ll try to add or change this Layout Update, you will get an error: “Custom layout update text cannot be changed, only removed”. So if you wish to change your previous layout updates or add new follow the instructions below.

Custom Layout Update xml file content

Lets remove title and breadcumbs as an example:

Custom Layout Update file names

1. For Category create file called: catalog_category_view_selectable_<Category ID>_<Name for Layout Update>.xml E.g.: catalog_category_view_selectable_20_WomenCategoryRemoveTitle.xml

Name for Layout Update can be anything. It is for you to understand what to choose in Custom layout update field. You can’t use any special symbols or spaces in Name for Layout Update, it should be a single word with uppercase only.

Now You’ll be able to see “Women Category Remove Title” in Custom Layout Update select for this particular category.

2. For Product pagecatalog_product_view_selectable_ <Product SKU>_<Name for Layout Update>.xml E.g.: catalog_category_view_selectable_mh08_oslo-trek-hoodie.xml

Product SKU is the desired product’s SKU encoded as a URI. example: “My Product SKU” -> “My%20Product%20SKU”

3. For CMS Pagescms_page_view_selectable_<CMS Page Identifier>_<Name for Layout Update>.xml E.g.: cms_page_view_selectable_about-us_AboutUs.xml

CMS Page Identifier is the desired page’s URL Key with “/” symbols replaced with “_”

Custom Layout Update file locations

  1. Category or Product: app/design/frontend/ <Vendor>/<Theme> /Magento_Catalog/layout/ E.g.: app/design/frontend/Olegnax/Athlete2/Magento_Catalog/layout/
  2. CMS Page: app/design/frontend/<Vendor>/<Theme>/Magento_Theme/layout/

For more details regarding layout customization please refer to Magento Official Documentation:

Default image
Sagar Doshi
CEO / Managing Partner

An expert in his field, Sagar Doshi is the CEO and team leader in


His passion for Magento has inspired others in the team too. Apart from work, he is a cricket lover."

Articles: 25

Leave a Reply