Adding Custom Field to Review Order Step in Magento Checkout

Adding Custom Field to Review Order Step in Magento Checkout

October 4, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding Custom Field to Review Order Step in Magento Checkout

Adding Custom Field to Review Order Step in Magento Checkout

As you’ve discovered, moving a custom field from the billing step to the review order step in the Magento checkout process requires a different approach than what is typically outlined in tutorials like the one you mentioned here. Let’s dive into this issue and find a solution that works for your specific use case.

Understanding the Magento Checkout Process

The Magento checkout process consists of several steps, each with its own event hook. The billing step has an checkout_controller_onepage_save_billing event, which is why your current observer (saveQuoteBefore) gets triggered when the field is on that step [1].

However, the review order step in Magento 2 uses a different layout and rendering mechanism than the other steps. This means it doesn’t have a standard event hook for data collection like the billing step does.

An Alternative Approach: Using a Custom Controller

To capture data from the review order step, you’ll need to create a new custom controller that extends Magento\Checkout\Controller\Index\Review. This controller will handle the post data and save it before the real review action is executed [2].

Here’s a basic example of how your custom controller might look:

namespace Excellence\Custom\Controller\Index;

use Magento\Framework\App\Action\Context;
use Magento\Framework\View\Result\PageFactory;

class Review extends \Magento\Checkout\Controller\Index\Review
{
    protected $resultPageFactory;

    public function __construct(Context $context, PageFactory $resultPageFactory)
    {
        $this->resultPageFactory = $resultPageFactory;
        parent::__construct($context);
    }

    public function execute()
    {
        if ($this->getRequest()->isPost()) {
            // Process the custom field data here
            $post = $this->getRequest()->getPost();
            if (isset($post['custom']['sales_person'])) {
                $var = $post['custom']['sales_person'];
                // Save or process your data as needed
            }
        }

        return parent::execute();
    }
}

Registering the Custom Controller

To use this custom controller, you’ll need to register it in your module’s di.xml file. You can override the existing review action and point it to your new controller:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Checkout\Controller\Index\Review">
        <arguments>
            <argument name="resultPageFactory" xsi:type="object">Excellence\Custom\Block\Result\Page</argument>
        </arguments>
    </type>
</config>

Conclusion

Adding a custom field to the review order step in Magento 2 requires a more advanced approach than simply using observers. By creating a custom controller that extends the existing review action, you can capture data from this step and process it as needed.

Remember, Magento’s architecture is complex, so always test changes thoroughly to ensure they don’t interfere with other core processes or extensions [3].

This solution should give you a starting point for capturing data on the review order step. If you have any further questions or need additional help integrating this into your specific setup, feel free to reach out.

Magento 2 Checkout Extensions Themes

Our network