Magento 2 Ui Component wysiwyg

Magento 2 Ui Component wysiwyg

July 26, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 Ui Component wysiwyg

Enhancing Magento 2 UI Components: Implementing WYSIWYG Editor for Text Area Fields

In Magento 2, the User Interface (UI) components offer a powerful way to create dynamic and responsive admin interfaces. One of the most common requirements is to add a WYSIWYG editor to text area fields within the form UI component XML file.

You’re on the right track by using the textarea as your formElement, but let’s dive deeper into how you can achieve this functionality effectively.

Understanding Magento 2 Form UI Components

Magento 2 uses a declarative approach for defining forms through XML. The field node is used to define individual form elements, and each field has several configuration options specified under the config item in the argument.

The key attributes you’ve already set include:

  • visible: Set to true to make the field visible.
  • dataType & formElement: Specify the type of data (text) and element (textarea).
  • source: The source model for retrieving/saving data.
  • label: The label displayed on the form.

Adding WYSIWYG Editor to Text Area Fields

To add a WYSIWYG editor, you need to use the ckeditor component provided by Magento. Here’s how you can modify your XML code:

<field name="detail">
    <argument name="data" xsi:type="array">
        <item name="config" xsi:type="array">
            <item name="visible" xsi:type="boolean">true</item>
            <item name="dataType" xsi:type="string">text</item>
            <item name="formElement" xsi:type="string">textarea</item>
            <item name="source" xsi:type="string">sample_shop</item>
            <item name="label" xsi:type="string">Detail</item>
            <item name="editorConfig" xsi:type="array">
                <item name="plugins" xsi:type="array">
                    <item name="ckeditor_wysiwyg" xsi:type="boolean">true</item>
                </item>
                <item name="toolbarButtonProvider" xsi:type="string">Vendor_Module/js/toolbars-toolbar-buttons-provider</item>
            </item>
        </item>
    </argument>
</field>

Key Changes Made

  1. Editor-specific configuration: We added an editorConfig item with two key settings.

  2. ckeditor_wysiwyg plugin: This enables the WYSIWYG functionality in your text area field.

  3. Toolbar button provider: Magento uses a separate JavaScript file to define the toolbar buttons for the editor. In this example, replace Vendor_Module with your actual vendor and module name.

Leveraging the power of Magento 2 UI Components

The flexibility provided by Magento 2’s UI components extends far beyond simple text area fields. You can create complex, responsive admin interfaces that meet your specific business needs.

To learn more about advanced Magento 2 development best practices, check out our comprehensive guide on Magento 2 Development Strategies by Laravel Company.

Conclusion

Adding a WYSIWYG editor to your text area fields in Magento 2 is an essential step for enhancing the admin user experience. By leveraging the ckeditor component and following the declarative XML approach, you can create dynamic forms that are both functional and visually appealing.

Remember to replace the example values with your actual vendor and module names when implementing this solution in your project. As always, feel free to explore more advanced features and techniques on our Magento Development Blog for a deeper dive into Magento 2’s capabilities.

Happy coding!

Magento 2 Admin Configuration

Our network