Reading list Switch to dark mode

    Add Custom Image Attribute To Category In Magento 2

    Add Custom Image Attribute To Category In Magento 2 – Here I’m going to explain you how to add custom image attribute to category.


    Create a AddCustomImageAttribute.php file on location vendor\Module\Setup\Patch\Data

    namespace Vendor\Module\Setup\Patch\Data;
    use Magento\Customer\Setup\CustomerSetupFactory;
    use Magento\Framework\Setup\ModuleDataSetupInterface;
    use Magento\Framework\Setup\Patch\DataPatchInterface;
    use Magento\Catalog\Model\Category;
    class AddCustomImageAttribute implements DataPatchInterface
        public const ATTRIBUTE_CODE = 'custom_image';
         * @var ModuleDataSetupInterface
        private $moduleDataSetup;
         * @var CustomerSetupFactory
        private $customerSetupFactory;
         * @param ModuleDataSetupInterface $moduleDataSetup
         * @param CustomerSetupFactory $customerSetupFactory
        public function __construct(
            ModuleDataSetupInterface $moduleDataSetup,
            CustomerSetupFactory $customerSetupFactory
        ) {
            $this->moduleDataSetup = $moduleDataSetup;
            $this->customerSetupFactory = $customerSetupFactory;
         * @inheritdoc
        public function apply()
            $customerSetup = $this->customerSetupFactory->create(['setup' => $this->moduleDataSetup]);
            $customerSetup->addAttribute(Category::ENTITY, self::ATTRIBUTE_CODE, [
                    'type' => 'varchar',
                    'label' => 'Custom Image',
                    'input' => 'image',
                    'backend' => \Magento\Catalog\Model\Category\Attribute\Backend\Image::class,
                    'required' => false,
                    'sort_order' => 9,
                    'global' => \Magento\Eav\Model\Entity\Attribute\ScopedAttributeInterface::SCOPE_STORE,
                    'group' => 'General Information',
         * @inheritdoc
        public static function getDependencies()
            return [];
         * @inheritdoc
        public function getAliases()
            return [];


    Create a category_form.xml file on location vendor\Module\view\adminhtml\ui_component

    Searching for an experienced
    Magento 2 Company ?
    Read More
    <?xml version="1.0" encoding="UTF-8"?>
    <form xmlns:xsi=""
        <fieldset name="content">
            <field name="custom_image">
                <argument name="data" xsi:type="array">
                    <item name="config" xsi:type="array">
                        <item name="dataType" xsi:type="string">string</item>
                        <item name="source" xsi:type="string">category</item>
                        <item name="label" xsi:type="string" translate="true">Custom Image</item>
                        <item name="visible" xsi:type="boolean">true</item>
                        <item name="formElement" xsi:type="string">fileUploader</item>
                        <item name="elementTmpl" xsi:type="string">ui/form/element/uploader/uploader</item>
                        <item name="previewTmpl" xsi:type="string">Magento_Catalog/image-preview</item>
                        <item name="required" xsi:type="boolean">false</item>
                        <item name="sortOrder" xsi:type="number">40</item>
                        <item name="uploaderConfig" xsi:type="array">
                            <item name="url" xsi:type="url" path="front_name/category_image/upload"/>


    Add below code in Vendor/Module/etc/di.xml

    <?xml version="1.0"?>
    <config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
        <preference for="Magento\Catalog\Model\Category\DataProvider" type="Webkul\ProductFileAttribute\Model\Category\DataProvider" />
        <type name="Webkul\ProductFileAttribute\Controller\Adminhtml\Category\Image\Upload">
                <argument name="imageUploader" xsi:type="object">Magento\Catalog\CategoryImageUpload</argument>
        <virtualType name="Magento\Catalog\CategoryImageUpload" type="Magento\Catalog\Model\ImageUploader">
                <argument name="baseTmpPath" xsi:type="string">catalog/tmp/category</argument>
                <argument name="basePath" xsi:type="string">catalog/category</argument>
                <argument name="allowedExtensions" xsi:type="array">
                    <item name="jpg" xsi:type="string">jpg</item>
                    <item name="jpeg" xsi:type="string">jpeg</item>
                    <item name="gif" xsi:type="string">gif</item>
                    <item name="png" xsi:type="string">png</item>


    Create Upload.php file on location Vendor/Module/Controller/Adminhtml/Category/Image

    namespace Vendor\Module\Controller\Adminhtml\Category\Image;
    use Magento\Framework\Controller\ResultFactory;
     * Adminhtml Category Image Upload Controller
    class Upload extends \Magento\Backend\App\Action
         * Image uploader
         * @var \Magento\Catalog\Model\ImageUploader
        protected $imageUploader;
         * Uploader factory
         * @var \Magento\MediaStorage\Model\File\UploaderFactory
        private $uploaderFactory;
         * Media directory object (writable).
         * @var \Magento\Framework\Filesystem\Directory\WriteInterface
        protected $mediaDirectory;
         * Store manager
         * @var \Magento\Store\Model\StoreManagerInterface
        protected $storeManager;
         * Core file storage database
         * @var \Magento\MediaStorage\Helper\File\Storage\Database
        protected $coreFileStorageDatabase;
         * @var \Psr\Log\LoggerInterface
        protected $logger;
         * Upload constructor.
         * @param \Magento\Backend\App\Action\Context $context
         * @param \Magento\Catalog\Model\ImageUploader $imageUploader
        public function __construct(
            \Magento\Backend\App\Action\Context $context,
            \Magento\Catalog\Model\ImageUploader $imageUploader,
            \Magento\MediaStorage\Model\File\UploaderFactory $uploaderFactory,
            \Magento\Framework\Filesystem $filesystem,
            \Magento\Store\Model\StoreManagerInterface $storeManager,
            \Magento\MediaStorage\Helper\File\Storage\Database $coreFileStorageDatabase,
            \Psr\Log\LoggerInterface $logger
        ) {
            $this->imageUploader = $imageUploader;
            $this->uploaderFactory = $uploaderFactory;
            $this->mediaDirectory = $filesystem->getDirectoryWrite(\Magento\Framework\App\Filesystem\DirectoryList::MEDIA);
            $this->storeManager = $storeManager;
            $this->coreFileStorageDatabase = $coreFileStorageDatabase;
            $this->logger = $logger;
         * Check admin permissions for this controller
         * @return boolean
        protected function _isAllowed()
            return $this->_authorization->isAllowed('Vendor_Module::category');
         * Upload file controller action
         * @return \Magento\Framework\Controller\ResultInterface
        public function execute()
            try {
                $result = $this->imageUploader->saveFileToTmpDir('custom_image');
                $result['cookie'] = [
                    'name' => $this->_getSession()->getName(),
                    'value' => $this->_getSession()->getSessionId(),
                    'lifetime' => $this->_getSession()->getCookieLifetime(),
                    'path' => $this->_getSession()->getCookiePath(),
                    'domain' => $this->_getSession()->getCookieDomain(),
            } catch (\Exception $e) {
                $result = ['error' => $e->getMessage(), 'errorcode' => $e->getCode()];
            return $this->resultFactory->create(ResultFactory::TYPE_JSON)->setData($result);


    Then create DataProvider.php file on location Vendor\Module\Model\Category

    namespace Vendor\Module\Model\Category;
    class DataProvider extends \Magento\Catalog\Model\Category\DataProvider
    	protected function getFieldsMap()
        	$fields = parent::getFieldsMap();
            $fields['content'][] = 'custom_image'; // custom image field
        	return $fields;


    Then at last create routes.xml on location Vendor\Module\etc\adminhtml

    <?xml version="1.0"?>
    <config xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
        <router id="admin">
            <route id="route_id" frontName="front_name">
                <module name="Vendor_Module"/>

    In this way we can add image attribute to category. Thanks…

    . . .
    Add a comment

    Leave a Comment

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


  • Samir
    can you provide route.xml code?
  • Mprasad
    How to create category multislect attribute with search box
  • Eran Greenwald
    Thank you for this post, it helped me a lot.
    When i upload an image i get 404 on this url:
    How can i fix this.

    Thanks 🙂

    • Huy Tran
      Just try add routes.xml into di/adminhtml.
      Replace module with your routes frontName.
      Your dir will separate with “_”: if your dir is Adminhtml/Category/Imageabc/Upload.php -> category_imageabc/upload
  • Sony
    Hi Rani,
    What was the Magento version when you did this tutorial ?
    I followed your steps on a Magento version 2.3 , but no luck.

    Actually all is working fine, except that the image is not saved.
    I think that we need to specify a custom backend source image which extends the native.

    • Rani Priya (Moderator)
      Hi Sony,

      Do you have created route for adminhtml? I mean etc/adminhtml/routes.xml file

      • Sony
        Hi yeah, i created the route. Weirdly it works now, do not know what change i made. But it seems working now, and at the end i used the native magento for the backend model ‘Magento\Catalog\Model\Category\Attribute\Backend\Image’, i did not need to create a custom backend model. Thanks ! 😉
  • Akshay
    Can you please explain.
    How to fetch this image in image src in frontend?
  • KW
    How do I install the module?
  • Fanboy
    A really good tutorial – could you add the part about creating the admin route so that this url part works.

  • sumeet
    Thanks,It is working fine.

    Thank you so much.

    • KW
      How do i enable or install the module after following the steps? Thanks!
      • Tom
        Run the “php bin/magento setup:upgrade” command 🙂
        • BilsTech
          php bin/magento cache:clear
  • Orvin Olson
    Not working,
    why you always not fill the full information ?
    getting this error – customcategorybannerimage/category_image/upload/key/a26831343598a8889c6c149f2976140ece250c41d2d4927c90117fd5a74bfab0/?isAjax=true

    and we know you not accept our comment

    • Rani Priya (Moderator)
      Hi Orvin,

      Hope it’s working fine at your end as well.

      In case if you will face any other issue then comment below we will surely help you.

  • Daniel Bello
    Hello, good job.
    How can we show this attribute on front end?
    • Rani Priya (Moderator)
      Hi Daniel,

      Please follow below steps in order to get image url at frontend.
      careate instance of class Magento\Catalog\Model\CategoryRepository
      then get category model by calling get method like
      $category = $categoryRepository->get($categoryId, $storeId);
      $imageUrl = “magento_media_url_path”.”catalog/category/”.$category->getCustomImage();
      And then you can use this $imageUrl in your custom category page or as per your design.


      • Karol
        any chance you write more specific in frontend part ? i cannot make this working ;(
        • Simon
          $this->_storeManager->getStore()->getBaseUrl(UrlInterface::URL_TYPE_MEDIA) . ‘catalog/category/’ . $category->getData(‘custom_image’);
  • Back to Top
    I really appreciate the quality of support they are very helpful I recommended this powerful module best solution with excellent support.
    Rzouga Aloui
    Talk to Sales


    Live Chat

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home