PHPackages                             falconmedia/magento2-flat-subcategories - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. falconmedia/magento2-flat-subcategories

ActiveMagento2-module[Utility & Helpers](/categories/utility)

falconmedia/magento2-flat-subcategories
=======================================

Flattened subcategory listing for category pages (siblings or full subtree).

1.0.0(7mo ago)10PHPPHP ^8.3

Since Oct 8Pushed 7mo agoCompare

[ Source](https://github.com/falconmedia/magento2-flat-subcategories)[ Packagist](https://packagist.org/packages/falconmedia/magento2-flat-subcategories)[ RSS](/packages/falconmedia-magento2-flat-subcategories/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

FalconMedia\_FlatSubcategories
==============================

[](#falconmedia_flatsubcategories)

Flattened subcategory listing on Magento 2 category pages.

Features
--------

[](#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
-------------

[](#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
---------

[](#placement)

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

Notes
-----

[](#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.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance64

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

216d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0ab506c6fbf58517ea41c5959be2ea46d89f403438433c6eb6042afcfd0b7c94?d=identicon)[falconmedia](/maintainers/falconmedia)

---

Top Contributors

[![henkvalk](https://avatars.githubusercontent.com/u/8955854?v=4)](https://github.com/henkvalk "henkvalk (1 commits)")

### Embed Badge

![Health badge](/badges/falconmedia-magento2-flat-subcategories/health.svg)

```
[![Health](https://phpackages.com/badges/falconmedia-magento2-flat-subcategories/health.svg)](https://phpackages.com/packages/falconmedia-magento2-flat-subcategories)
```

###  Alternatives

[baldwin/magento2-module-url-data-integrity-checker

Magento 2 module which can find potential url related problems in your catalog data

281773.3k](/packages/baldwin-magento2-module-url-data-integrity-checker)[trustpilot/module-reviews

The Trustpilot Review extension makes it simple and easy for merchants to collect reviews from their customers to power their marketing efforts, increase sales conversion, build their online reputation and draw business insights.

12886.7k](/packages/trustpilot-module-reviews)[graycore/magento2-graphql-introspection-cache

1015.2k](/packages/graycore-magento2-graphql-introspection-cache)[elgentos/magento2-structured-data

Implement structured data for Magento 2 webshops.

1444.7k](/packages/elgentos-magento2-structured-data)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

126.8k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)