Creating New Category Attributes in Magento 2

While developing Magento 2 website, many times you may require to create new category attributes. But there is no option on the admin side to add new category attribute in Magento 2. So we have to create an installable script to add new category attribute. This blog will help you to create new category attribute in Magento 2 programmatically.

You may also like one of our blogs “Create Custom Attribute Group & Product Attribute in Magento 2 via InstallData.php

Step 1: Module Registration

Create a new custom module based on the Magento 2 structure in the below file path,

File Path: app/code/BlogTreat/CategoryAttribute/registration.php


Step 2: Module Configuration

Create a module.xml file in the below file path to define new Magento 2 extension

File Path: app/code/BlogTreat/CategoryAttribute/etc/module.xml

<?xml version="1.0"?>
<config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="BlogTreat_CategoryAttribute" setup_version="1.0.0">

Step 3: Create a Setup File

Create a setup file InstallData.php in the below file path,

File Path: app/code/BlogTreat/CategoryAttribute/Setup/InstallData.php

namespace BlogTreat\CategoryAttribute\Setup;
use Magento\Eav\Setup\EavSetupFactory;
use Magento\Framework\Setup\InstallDataInterface;
use Magento\Framework\Setup\ModuleContextInterface;
use Magento\Framework\Setup\ModuleDataSetupInterface;
use Magento\Eav\Model\Entity\Attribute\ScopedAttributeInterface;

class InstallData implements InstallDataInterface
     * EAV setup factory
     * @var EavSetupFactory
    private $eavSetupFactory;

     * Init
     * @param EavSetupFactory $eavSetupFactory
    public function __construct(EavSetupFactory $eavSetupFactory)
        $this->eavSetupFactory = $eavSetupFactory;

     * {@inheritdoc}
    public function install(ModuleDataSetupInterface $setup, ModuleContextInterface $context)

        /** @var EavSetup $eavSetup */
        $eavSetup = $this->eavSetupFactory->create(['setup' => $setup]);

         * Add attributes to the eav/attribute
                'group' => 'General Information',
                'type' => 'varchar',
                'label' => 'Custom Attribute',
                'input' => 'text',
                'required' => false,
                'sort_order' => 100,
                'global' => ScopedAttributeInterface::SCOPE_GLOBAL,
                'user_defined' => true,
                'is_used_in_grid' => true,
                'is_visible_in_grid' => false,
                'is_filterable_in_grid' => true,


Step 4: Show Category Attribute in Admin Form

In the latest Magento 2 versions, the category form on the admin panel is created via the configuration file category_form.xml. You can found the configuration file in the path vendor/magento/module-catalog/view/adminhtml/ui_component/category_form.xml, so we need to create the same configuration file in our module and add our category attribute to the category form as follows,

File Path: app/code/BlogTreat/CategoryAttribute/view/adminhtml/ui_component/category_form.xml

<?xml version="1.0" ?>
<form xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Ui:etc/ui_configuration.xsd">
    <fieldset name="general">
        <field name="custom_attribute">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="required" xsi:type="boolean">false</item>
                    <item name="validation" xsi:type="array">
                        <item name="required-entry" xsi:type="boolean">false</item>
                    <item name="sortOrder" xsi:type="number">100</item>
                    <item name="dataType" xsi:type="string">string</item>
                    <item name="formElement" xsi:type="string">input</item>
                    <item name="label" translate="true" xsi:type="string">Custom Attribute</item>

After completing the above steps run the below SSH command in your Magento 2 installed root directory,

php bin/magento setup:upgrade

Then, clear all the Magento cache and check whether the extension has been successfully installed in Magento 2 admin.

Once the extension has been installed you will be able to view the category attribute in admin side as shown in the screenshot below,

Creating New Category Attributes in Magento 2

Hope this helps.

One Comment on “Creating New Category Attributes in Magento 2”

Leave a Reply

Your email address will not be published. Required fields are marked *