Magento 2 Page Builder - custom content type missing settings

Magento 2 Page Builder - custom content type missing settings

July 29, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 Page Builder - custom content type missing settings

Creating a custom quote block for Magento Page Builder involves several key steps, including extending the Page Builder plugin system, defining the form fields for the widget, and implementing the rendering logic.

To begin, you need to extend the existing Page Builder plugin system by creating a new module called Binea_PageBuilderQuote. Within this module, define your configuration file under app/code/Binea/PageBuilderQuote etc/module.xml:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Binea_PageBuilderQuote" setup_version="1.0.0">
        <sequence>
            <module name="Magento_PageBuilder"/>
        </sequence>
    </module>
</config>

Next, create the configuration file for your quote widget under app/code/Binea/PageBuilderQuote etc/pagebuilder_quote.xml:

<page-builder-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_PageBuilder:etc/config.xsd">
    <widgets>
        <widget name="Binea_QuoteBlock">
            <settings>
                <title translate="true">Quote Block</title>
                <description translate="true">Add a quote block with custom appearance and style options.</description>
            </settings>
            <fields>
                <field name="general" sortOrder="0" formElement="fieldset" componentType="Magento_PageBuilder/js/form/element/section">
                    <arguments>
                        <argument name="config" xsi:type="array">
                            <item name="label" xsi:type="string">Quote Block</item>
                            <item name="collapsible" xsi:type="boolean">false</item>
                        </argument>
                    </arguments>
                </field>
            </fields>
        </widget>
    </widgets>
</page-builder-config>

Now, create the form fields for your quote widget under app/code/Binea/PageBuilderQuote/etc/pagebuilder_quote_form.xml:

<form xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Ui:number-field.xsd">
    <fieldset name="appearance" sortOrder="0">
        <settings>
            <label translate="true">Appearance</label>
        </settings>
        <field name="appearance" formElement="select" sortOrder="10" component="Magento_PageBuilder/js/form/element/dependent-visual-select">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="default" xsi:type="string">default</item>
                </item>
            </argument>
            <settings>
                <additionalClasses>
                    <class name="admin__field-wide">true</class>
                    <class name="admin__field-visual-select-container">true</class>
                </additionalClasses>
                <dataType>text</dataType>
                <validation>
                    <rule name="required-entry" xsi:type="boolean">true</rule>
                </validation>
                <elementTmpl>Magento_PageBuilder/form/element/visual-select</elementTmpl>
            </settings>
            <formElements>
                <select>
                    <settings>
                        <options class="AppearanceSourceQuote"/>
                    </settings>
                </select>
            </formElements>
        </field>
    </fieldset>
    <fieldset name="general" sortOrder="20">
        <settings>
            <label/>
        </settings>
        <field name="quote_text" sortOrder="10" formElement="textarea">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="source" xsi:type="string">page</item>
                </item>
            </argument>
            <settings>
                <dataScope>quote_text</dataScope>
                <dataType>text</dataType>
                <label translate="true">Quote</label>
            </settings>
        </field>
        <field name="quote_author" sortOrder="20" formElement="input">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="source" xsi:type="string">page</item>
                </item>
            </argument>
            <settings>
                <dataScope>quote_author</dataScope>
                <dataType>text</dataType>
                <label translate="false">Author</label>
            </settings>
        </field>
        <field name="quote_author_desc" sortOrder="30" formElement="input">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="source" xsi:type="string">page</item>
                </item>
            </argument>
            <settings>
                <dataScope>quote_author_desc</dataScope>
                <dataType>text</dataType>
                <label translate="false">Author Description</label>
            </settings>
        </field>
        <field name="quote_css" sortOrder="40" formElement="select">
            <argument name="data" xsi:type="array">
                <item name="config" xsi:type="array">
                    <item name="default" xsi:type="string">black-quote</item>
                </item>
            </argument>
            <settings>
                <dataType>text</dataType>
                <label translate="true">Quote Color</label>
            </settings>
            <formElements>
                <select>
                    <settings>
                        <options>
                            <option name="0" xsi:type="array">
                                <item name="value" xsi:type="string">black-quote</item>
                                <item name="label" xsi:type="string" translate="true">Black</item>
                            </option>
                            <option name="1" xsi:type="array">
                                <item name="value" xsi:type="string">blue-quote</item>
                                <item name="label" xsi:type="string" translate="true">Blue</item>
                            </option>
                            <option name="2" xsi:type="array">
                                <item name="value" xsi:type="string">green-quote</item>
                                <item name="label" xsi:type="string" translate="true">Green</item>
                            </option>
                            <option name="3" xsi:type="array">
                                <item name="value" xsi:type="string">red-quote</item>
                                <item name="label" xsi:type="string" translate="true">Red</item>
                            </option>
                            <option name="4" xsi:type="array">
                                <item name="value" xsi:type="string">purple-quote</item>
                                <item name="label" xsi:type="string" translate="true">Purple</item>
                            </option>
                        </options>
                    </settings>
                </select>
            </formElements>
        </field>
    </fieldset>
</form>

Finally, create the layout file for your quote widget under app/code/Binea/PageBuilderQuote/view/adminhtml/layout/pagebuilder_binea_quote_form.xml:

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" layout="admin-1column" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="styles"/>
    <body>
        <referenceContainer name="content">
            <uiComponent name="pagebuilder_binea_quote_form"/>
        </referenceContainer>
    </body>
</page>

To ensure proper integration with Magento Page Builder, you need to follow the following steps:

  1. Install the Binea_PageBuilderQuote module in your Magento installation.
  2. Enable and configure the Binea_PageBuilderQuote module according to your requirements.
  3. Add the quote widget using the “Add Widget” button in the Page Builder interface.
  4. Configure the desired appearance, text, author, and color options for the quote block.

This custom quote block will now be available in your Magento Page Builder interface, allowing you to easily add quotes with different styles and appearances to your website’s content.

Magento 2 Extensions Configuration Orders

Our network