Issue Adding custom product attribute with UI Select - Magento 2

Issue Adding custom product attribute with UI Select - Magento 2

September 10, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Issue Adding custom product attribute with UI Select - Magento 2

Solving the Magento 2 Custom Product Attribute UI Select Issue

You’re facing an issue where your custom product attribute is appearing twice - once as a default select and again as UI-Select in the admin panel of Magento 2. Let’s troubleshoot this problem step by step.

Understanding the Current Setup

Your setup script correctly creates a new product attribute named ‘location’ with various configurations like input type, group, and source. You’ve also configured it to be visible on both the frontend and backend.

In your product.xml file under the adminhtml UI component path, you’re properly setting up the field for this attribute using the Magento_Ui/js/form/element/ui-select component, which is intended for UI Select.

The Issue: Two Appearances of the Same Attribute

The issue lies in the way Magento processes and renders attributes. When you create an attribute with a select input type, it automatically creates a default select option. Then, if you configure this same attribute to use a specific field component like UI-Select in the UI configuration XML file, Magento treats it as a separate field.

This is why you’re seeing two appearances of the ‘location’ attribute - one is the default select created by the attribute setup, and the other is the UI-Select you’ve configured manually.

The Solution: Merge Both Appearances

To resolve this issue without creating duplicate attributes, you need to merge these two appearances into a single field in your product.xml file. Here’s how:

  1. Remove the default <field name="location"> section from your product.xml file that was automatically generated by Magento.

  2. In your custom XML configuration for the ‘location’ attribute, change the componentType to “container”. This tells Magento to treat this field as a container for other elements rather than a standalone field.

  3. Replace the existing <argument name="data"> section with the following:

<argument name="data" xsi:type="array">
    <item name="config" xsi:type="array">
        ...
        <item name="componentType" xsi:type="string">container</item>
        <item name="renderers" xsi:type="array">
            <item name="VendorName/Module/js/location-renderer" xsi:type="string"/>
        </item>
    </item>
</argument>
  1. Create a new JavaScript file named location-renderer.js in the view/adminhtml/web/js directory of your module. This file will be responsible for rendering the UI-Select component.

  2. Add the following code to your location-renderer.js file:

define([
    'Magento_Ui/js/form/element/ui-select'
], function (Component) {
    'use strict';

    return Component.extend({
        initialize: function () {
            this._super();
        }
    });
});
  1. Save all changes and clear your Magento cache.

Verifying the Solution

After making these changes, log out of your admin panel and then log back in. Navigate to a product and check the ‘location’ field under the ‘General’ tab.

You should now see only one field for the location attribute - a UI-Select component that uses lazy loading for efficient data handling.

Conclusion

Understanding how Magento handles attributes is key to avoiding such issues. The default select option created by an attribute setup can sometimes conflict with manual configurations in adminhtml XML files, leading to duplicate appearances.

By merging the field configurations and creating a custom renderer, you’ve successfully resolved the issue without duplicating the attribute. This solution ensures that your location attribute appears as intended - a single UI-Select component with lazy loading enabled for optimal performance in your Magento 2 store.

Remember to always clear your cache after making changes to XML files or JavaScript components in Magento to ensure your updates take effect.

For more detailed insights and best practices on managing product attributes in Magento 2, I recommend checking out our comprehensive guide at https://laravelcompany.com/magento-2-product-attribute-guide. It provides a step-by-step walkthrough of creating, managing, and optimizing product attributes for better performance and user experience.

Magento 2 Catalog Admin Configuration

Our network