Magento 2 How can I override core system.xml file

Magento 2 How can I override core system.xml file

September 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 How can I override core system.xml file

Overriding Core System.xml File in Magento 2

Hello, Magento developers! I hope this post finds you well.

The Problem: Overriding CatalogInventory’s system.xml

You’re facing a common challenge - overriding the core CatalogInventory module’s system.xml file to change the backorder setting from global to website-specific. Let me walk you through the steps and best practices for achieving this.

Understanding the Current System.xml Structure

The default Magento 2 setup has the following structure for the CatalogInventory system.xml:

<system xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <section id="cataloginventory" translate="label" type="text" sortOrder="50" showInDefault="1" showInWebsite="1" showInStore="1">
            <!-- Group and fields here -->
        </section>
    </system>
</config>

The backorders field under the item_options group has showInWebsite set to 0, which means it’s not visible at the website level in the default configuration.

The Solution: Overriding the system.xml File

To override this file, you’ll need to create a new module and define your custom system.xml. Here’s how:

Step 1: Create Your Custom Module

First, create a new directory under app/code/VendorName/ModuleName for your custom module. Replace VendorName with your vendor code and ModuleName with the name you choose.

Step 2: Define Your system.xml File

Under the etc/adminhtml directory of your module, create a new file named system.xml. The content should look like this:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <section id="cataloginventory" translate="label" type="text" sortOrder="50" showInDefault="1" showInWebsite="1" showInStore="1">
            <group id="item_options" translate="label comment" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                <field id="backorders" translate="label" type="select" sortOrder="3" showInDefault="1" showInWebsite="1" showInStore="1" canRestore="1">
                    <!-- Your field configuration here -->
                </field>
            </group>
        </section>
    </system>
</config>

Step 3: Update the Field Configuration

Inside your custom system.xml, find the backorders field and update its showInWebsite attribute to 1:

<field id="backorders" translate="label" type="select" sortOrder="3" showInDefault="1" showInWebsite="1" showInStore="0" canRestore="1">
    <!-- Your field configuration here -->
</field>

Step 4: Enable and Compile Your Module

After creating the module and updating the system.xml, enable it in your Magento admin under Stores > Configuration > Advanced. Then, run the following commands to compile your code:

php bin/magento setup:upgrade
php bin/magento setup:di:compile

Conclusion

You’ve now successfully overridden the core CatalogInventory module’s system.xml file and allowed the backorder setting to be visible at the website level. This approach ensures that you’re not directly modifying any core files, which is a best practice for maintaining upgrade compatibility.

Remember to always follow Magento’s coding standards and documentation when working with system.xml files. If you have any other questions or need further clarification, feel free to reach out.

Happy coding!

Magento 2 Catalog Extensions Configuration

Our network