Change text Upsell in Magento Product Edit (admin page)

Change text Upsell in Magento Product Edit (admin page)

September 17, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Change text Upsell in Magento Product Edit (admin page)

Changing “Up-sell” Text on Magento Product Edit Page

Are you trying to customize the “Up-sell” label on the product edit page of your Magento admin interface? You’ve come to the right place. Let’s dive into how you can achieve this without modifying core files, which is a best practice for maintaining upgrade compatibility.

Understanding the Structure

In Magento 2, the admin backend layout and text labels are defined in XML files under the app/design directory of your active theme or customization. To change the “Up-sell” label, we need to locate the relevant XML configuration file that controls this section of the product edit page.

Finding the Right File

The key file you’re looking for is located at:

app/design/<your_theme>/Magento_Theme/layout/requires-js.xml

Replace <your_theme> with the name of your active theme or customization. If you haven’t created a child theme yet, consider creating one to avoid losing changes during upgrades.

Changing the “Up-sell” Label

Open the requires-js.xml file in your preferred text editor or IDE. Look for the following block:

<referenceContainer name="content">
    <block type="Magento\Catalog\Block\Adminhtml\Product\Edit\Tab\Products\Upsells"
            before="-">
        <action method="setTemplate">
            <argument name="template" xsi:type="string">Magento_Catalog::product/edit/tab/upsell.phtml</argument>
        </action>
    </block>
</referenceContainer>

This is where the “Up-sell” label is defined. To change it, modify the inner action block as follows:

<referenceContainer name="content">
    <block type="Magento\Catalog\Block\Adminhtml\Product\Edit\Tab\Products\Upsells"
            before="-">
        <action method="setTemplate">
            <argument name="template" xsi:type="string">Magento_Catalog::product/edit/tab/custom-upsell.phtml</argument>
        </action>
    </block>
</referenceContainer>

We’ve simply renamed the template file from upsell.phtml to custom-upsell.phtml.

Creating the Custom Template

Next, create a new PHTML file at:

app/design/<your_theme>/Magento_Catalog/templates/product/edit/tab/custom-upsell.phtml

Inside this new file, you can modify the “Up-sell” label by updating the relevant HTML element. For example, to change it to “Recommended Products”:

<div class="admin__field-field">
    <label data-bind="attr: { 'for': id }"
           class="admin__field-label">
        <?php /* @escapeNotVerified */ echo __('Recommended Products') ?>
    </label>
</div>

Save the file and clear your Magento cache.

Conclusion

You’ve now successfully changed the “Up-sell” label to “Recommended Products” on the product edit page of your Magento admin interface. By using this approach, you avoid modifying core files and ensure that your changes remain after upgrades.

Remember, always test your customizations thoroughly before deploying them to a live environment. If you need further assistance in customizing your Magento store or require professional development services, feel free to reach out to us at Laravel Company.

Happy coding!

Magento 2 Catalog Themes Admin

Our network