Get Free Audit

A “Category Chooser” in Magento 2 Backend

Mar 16, 2017

6422 Mishel Soiko

A “Category Chooser” in Magento 2 Backend

Let’s imagine, you need to create a category chooser for magento admin panel. For example, this might be necessary in the following cases:

1. To be used for some standard form as follows:

2. For some backend configurations:

3. Or, like in my case, for some widgets:

So, let’s consider how it is possible to arrange that. Magento source code offers us several solutions but we have selected the simplest one to use. First off, we write down the code for the element itself:

magento development services

Magento Custom Development

Take your online store to the next level with BelVG Magento custom development

Visit the page

But that is only a form’s input. Now, let’s write down some html and javascript code to output the chooser in the backend and let it perform properly:


Partner With Us

Let's discuss how to grow your business. Get a Free Quote.
Talk to Andrey

So, this is the Multi Category Chooser. But what if we need only one category? For such case there is a ready-made solution available, so we do not need to invent anything new:

This solution I have applied for one of my widgets, but it is also possible to adapt it for configuring various form elements.


Groups Catalog for Magento 2

Take your online store to the next level with BelVG module

Download here

Want to keep track of your store’s unregistered users? Download our free Magento Guests Catalog extension.

Andrey Dubina

Partner With Us

Looking for a partner to grow your business? We are the right company to bring your webstore to success. Talk to Andrey


  1. Hi, Sukumar! Thanks for your question.

    Vendor – the name of the vendor that you assign as you create a module
    Module – the name of the module
    Chooser – name of the class that you assigned to your chooser.

    We wrote these attributes in brackets because they are individually assigned by each user; this is how we called ours, but yours could have different names.

  2. Hi.
    I am getting error when adding to custom admin form.
    \Vendor\Module\Block\Adminhtml\Chooser doesn’n extend \Magento\Framework\Data\Form\Element\AbstractElement

    Can you please help me to solve this?

  3. Hi, Arnau, thanks for your question!

    If you follow this path Magento\Widget\Controller\Adminhtml\Widget\Instance, you’ll find different classes for Choosers. Personally I use Category for mine.
    There is another path Magento\Catalog\Block\Adminhtml\Category\Widget\Chooser.
    Bear in mind that Magento is upgraded from time to time, so this aspect can change.

    I hope I answered your question. Best wishes!

  4. Hi Kosta,
    We see that the queries are sent to ‘adminhtml/widget_instance/categories’. It’s all in your hands. Change the sent ajax parameters (parameters : postParameters). This must help.

  5. Hello!It’s a very good approach. Can you explain why the only available categories to choose are only the NON anchor categories?

  6. Hi Roshan,
    The article describes the creation of one file: [Vendor]\[Modul]\Block\Adminhtml\[Chooser], which is a form element. All these blocks are similar – there are plenty of examples. Do not be lazy and try to explore it yourself: \Magento\Config\Block\System\Config\*. There are three examples of adding fields to a form described at the beginning of the article. Each of the examples is used in many of the modules in default Magento.

  7. Can you please specify the file names as suggested above because that will really help a lot for creating the new type and used in the form.

  8. Dear Daniel,

    the code is above, in the article. Just put it into your module.
    In this case, we used the code from one of the client’s projects; the module where this code was created is more extensive.


Post a new comment

BelVG Newsletter
Subscribe to our mailing list and get interesting stuff and updates to your email inbox.
Email *