PHPackages                             macopedia/magento2-categoryimporter - 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. [CLI & Console](/categories/cli)
4. /
5. macopedia/magento2-categoryimporter

ActiveMagento2-module[CLI & Console](/categories/cli)

macopedia/magento2-categoryimporter
===================================

Category Importer for Magento 2

1.0.0(5y ago)344.6k23[1 PRs](https://github.com/macopedia/CategoryImporter/pulls)OSL-3.0PHP

Since Jun 10Pushed 2y ago14 watchersCompare

[ Source](https://github.com/macopedia/CategoryImporter)[ Packagist](https://packagist.org/packages/macopedia/magento2-categoryimporter)[ RSS](/packages/macopedia-magento2-categoryimporter/feed)WikiDiscussions master Synced 1mo ago

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

CategoryImporter module for Magento 2 >= 2.1.x
=================================================

[](#categoryimporter-module-for-magento-2--21x)

Simple category importer from CSV file. Allows to import / update categories not only from Magento shops (use old shop category ID)

Features
========

[](#features)

- adds attribute to category 'Old category ID'
- adds possibility to add custom attribute codes by command option
- adds links between parent and child categories (by 'Old category ID')
- work only for admin store (multi stores are not implemented yet)

Install module
==============

[](#install-module)

- add module via composer or download and copy files to app/code/Macopedia/CategoryImporter
- run bin/magento module:enable Macopedia\_CategoryImporter in command line

Usage
=====

[](#usage)

**NOTICES:**

- please add parent categories before children in file
- use semicolon (';') as delimiter in file

**Attributes supported by default:**

- Required attributes:

    - id
    - name
    - parent\_id
- Optional attributes with predefined values:

    - is\_active - default value: 1
    - is\_anchor - default value: 1
    - include\_in\_menu - default value: 1
    - custom\_use\_parent\_settings - default value: 1
- Base additional attributes:

    - description
    - meta\_title
    - meta\_keywords
    - meta\_description
    - url\_key
    - url\_path
    - position

**Base usage examples**

```
bin/magento import:categories [--path|-p ] [--additional|-a ]

bin/magento import:categories -p var/import/categories-example.csv

bin/magento import:categories -p var/import/categories-example.csv -a my_custom_attribute1,my_custom_attribute2,my_custom_attribute3

```

**Simple CSV file to import categories**

```
id;name;parent_id
10;Category name 1;null
11;Category name 2;null
20;First child of cat 1;10
21;First child of cat 2;11
22;Second child of cat 2;11

```

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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

2160d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e44feab70b3b53b27178be962a8b5474af354f85292f2a662f015f022fdd3c11?d=identicon)[tmotyl](/maintainers/tmotyl)

---

Top Contributors

[![idziakjakub](https://avatars.githubusercontent.com/u/7571848?v=4)](https://github.com/idziakjakub "idziakjakub (3 commits)")[![tmotyl](https://avatars.githubusercontent.com/u/515397?v=4)](https://github.com/tmotyl "tmotyl (2 commits)")[![oviliz](https://avatars.githubusercontent.com/u/73616?v=4)](https://github.com/oviliz "oviliz (1 commits)")

---

Tags

categoriescategorycommand-linecommand-line-toolconsoleimportimportermagento2magento2-extensionmagento2-importmagento2-module

### Embed Badge

![Health badge](/badges/macopedia-magento2-categoryimporter/health.svg)

```
[![Health](https://phpackages.com/badges/macopedia-magento2-categoryimporter/health.svg)](https://phpackages.com/packages/macopedia-magento2-categoryimporter)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.2M1](/packages/fastly-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[yireo/magento2-theme-commands

CLI commands to manipulate themes

1334.2k1](/packages/yireo-magento2-theme-commands)[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)