README

Flattened subcategory listing on Magento 2 category pages.

Features

• Display all subcategories at the same visual level:
  • Flattened subtree: show all descendants of the top category under the store root.
  • Siblings only: show all direct siblings of the current category.
• Configurable sorting (name or position) and max items.
• Optional category images (configurable attribute code, default image).
• Clean ViewModel, no ObjectManager usage.
• Works with Luma; Tailwind/Alpine-friendly markup.

Configuration

Stores > Configuration > Catalog > Flat Subcategories

• Enable module: yes/no
• Display mode: Flattened subtree or Only siblings
• Max items: 0 or empty means unlimited
• Sort by: name or position
• Show category image: yes/no
• Image attribute code: default image

Placement

Injected into catalog_category_view under the content container via layout XML: view/frontend/layout/catalog_category_view.xml.

Notes

• The "flattened subtree" determines the top category as the first node after the store root within the current category path.
• Only active categories in the current store are shown.