PHPackages aichouchm/magento2-module-attribute-import - 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. aichouchm/magento2-module-attribute-import ActiveMagento2-module[Utility & Helpers](/categories/utility) aichouchm/magento2-module-attribute-import ========================================== Magento 2 module for bulk importing product attribute options from CSV files via the admin panel 0241PHP Since Apr 24Pushed 3mo agoCompare [ Source](https://github.com/mehdiaichouch2002/Aichouchm-AttributeImport)[ Packagist](https://packagist.org/packages/aichouchm/magento2-module-attribute-import)[ RSS](/packages/aichouchm-magento2-module-attribute-import/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependenciesVersions (1)Used By (0) Aichouchm\_AttributeImport ========================== [](#aichouchm_attributeimport) **Magento 2 module for bulk importing product attribute options from CSV files via the Admin Panel.** --- Overview -------- [](#overview) Magento 2 has no native way to bulk-import attribute options (the selectable values of a `select` or `multiselect` attribute, such as colors, sizes, or materials). The only built-in approach is clicking "Add Option" dozens of times in the admin UI — one row at a time. This module adds a dedicated page under **Stores → Attributes → Import Attributes** that lets an admin: 1. Select an attribute (e.g. `color`) 2. Upload a CSV file containing all desired option values, their translations per store view, and (optionally) swatch data 3. Preview and validate the file before committing 4. Import with one click — new options are created, duplicates are logged and skipped 5. Review the import log directly in the admin panel --- Requirements ------------ [](#requirements) DependencyVersionPHP≥ 8.1Magento Open Source / Adobe Commerce2.4.x`magento/module-swatches`bundled with Magento--- Installation ------------ [](#installation) ``` composer require aichouchm/magento2-module-attribute-import bin/magento module:enable Aichouchm_AttributeImport bin/magento setup:upgrade bin/magento cache:flush ``` --- Admin Panel Location -------------------- [](#admin-panel-location) **Stores → Attributes → Import Attributes** A **View Log** button on the import page opens the log viewer directly. --- CSV Format ---------- [](#csv-format) All attributes use the same **6-column format** regardless of type: ``` attribute_code,store_view,value,hex_code,sort_order,is_default ``` ### Plain `select` attribute (no swatch) — leave `hex_code` empty [](#plain-select-attribute-no-swatch--leave-hex_code-empty) ``` attribute_code,store_view,value,hex_code,sort_order,is_default size,default,Small,,1,1 size,fr,Petite,,1,1 size,en,Small,,1,1 size,default,Medium,,2,0 size,fr,Moyenne,,2,0 size,en,Medium,,2,0 ``` ### Visual swatch attribute — provide `#RRGGBB` in `hex_code` [](#visual-swatch-attribute--provide-rrggbb-in-hex_code) ``` attribute_code,store_view,value,hex_code,sort_order,is_default color,default,Red,#FF0000,1,1 color,fr,Rouge,#FF0000,1,1 color,en,Red,#FF0000,1,1 color,default,Blue,#0000FF,2,0 color,fr,Bleu,#0000FF,2,0 color,en,Blue,#0000FF,2,0 ``` --- Column Reference ---------------- [](#column-reference) ColumnRequiredDescription`attribute_code`YesMust match the attribute you selected in the form. Every row must have the same value.`store_view`Yes`default` or `admin` = global label (store\_id=0). Any other value must be a valid Magento store code (e.g. `fr`, `en`).`value`YesThe option label for this store view.`hex_code`Yes (visual swatch only)Hex colour (`#RRGGBB`). Leave empty for plain `select` and `multiselect` attributes.`sort_order`Yes (admin row only)Integer. Controls the display order of the option in dropdowns.`is_default`Yes (admin row only)`1` = this option is the default selected value. Only one option may have `is_default=1`.--- Row Grouping Rules ------------------ [](#row-grouping-rules) Each option is defined as a **group** of rows: - The **first row** of a group has `store_view = default` (or `admin`) — this is the global (admin-store) label. - Subsequent rows have other store view codes — these are translations. - A new group begins at the next `default`/`admin` row. ``` color,default,Red,#FF0000,1,1 ← start of group 1 (sort_order and is_default set here) color,fr,Rouge,#FF0000,1,1 ← translation for "fr" store color,en,Red,#FF0000,1,1 ← translation for "en" store color,default,Blue,#0000FF,2,0 ← start of group 2 color,fr,Bleu,#0000FF,2,0 color,en,Blue,#0000FF,2,0 ``` --- Validation Rules ---------------- [](#validation-rules) The **Check Data** button validates the file before any data is written: RuleSeverity`sort_order` must be a numberError — blocks import`is_default` must be `0` or `1`Error — blocks importOnly one option may have `is_default=1`Error — blocks importNo duplicate values within the same `default`/`admin` store in the CSVError — blocks import`hex_code` must be a valid `#RRGGBB` colour for visual swatch attributesError — blocks importOption value already exists in the databaseWarning — logs and skips--- Duplicate Handling ------------------ [](#duplicate-handling) If an option value already exists in the database for the selected attribute, the module **skips it silently** (logs a warning) instead of overwriting it. This is intentional — it protects options that have been manually adjusted by an admin. Skipped values appear in the import result message and in the log file. --- Logging ------- [](#logging) Every import action is logged to: ``` var/log/attribute_import.log ``` Each entry includes a timestamp, log level, and a message. Entries are visible from **Stores → Attributes → Import Attributes → View Log** without needing server access. Log levels used: LevelWhenINFOImport started, import completed with summaryWARNINGOption skipped because it already existsERRORValidation failure, unexpected exception--- Architecture Summary -------------------- [](#architecture-summary) ``` CSV upload │ ▼ StreamingReader ← fgetcsv generator — O(1) memory per row │ ▼ Validator ← stateless, returns error list — no DB writes │ ▼ (only if valid) ImportService ← groups rows by option, pre-loads existing options once │ ▼ OptionProcessor ← bulk DB writes: insertOnDuplicate for labels and swatches │ ▼ CacheManager ← clears eav + full_page caches │ ▼ Logger ← writes to var/log/attribute_import.log ``` --- ACL / Permissions ----------------- [](#acl--permissions) The module registers one ACL resource: ``` Magento_Backend::stores └── Magento_Backend::stores_attributes └── Aichouchm_AttributeImport::import_attributes ← "Import Attributes" ``` Assign this resource to any admin role that needs access to the import page. --- Supported Attribute Types ------------------------- [](#supported-attribute-types) Frontend InputSupported`select`Yes`multiselect`Yes`swatch_visual`Yes (hex + image URL)`swatch_text`Yes`boolean`, `date`, `text`, etc.No — these have no optionsSystem attributes (`is_user_defined = false`) are excluded from the attribute selector to prevent accidental modification of core Magento configuration. --- Compatibility ------------- [](#compatibility) - Tested with Magento 2.4.6 and 2.4.7 - Compatible with Varnish full-page caching (module clears `eav` and `full_page` cache tags after import) - Compatible with Redis page cache --- License ------- [](#license) MIT — see [LICENSE](LICENSE) file. ### Health Score 20 — LowBetter than 12% of packages Maintenance55 Moderate activity, may be stable Popularity7 Limited adoption so far Community4 Small or concentrated contributor base Maturity12 Early-stage or recently created project 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. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/141225500?v=4)[Mehdi](/maintainers/mehdiaichouch2002)[@mehdiaichouch2002](https://github.com/mehdiaichouch2002) ### Embed Badge ![Health badge](/badges/aichouchm-magento2-module-attribute-import/health.svg) ``` [![Health](https://phpackages.com/badges/aichouchm-magento2-module-attribute-import/health.svg)](https://phpackages.com/packages/aichouchm-magento2-module-attribute-import) ``` ### Alternatives [phpcfdi/cfdi-cleaner Clean up Mexican CFDI 1344.4k1](/packages/phpcfdi-cfdi-cleaner) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)