Magento 2 - Redirects search if only one result

Magento 2 - Redirects search if only one result

October 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 - Redirects search if only one result

Automating Magento 2 Search: Redirecting to Single Result

Search functionality is one of the most important features for any e-commerce platform. In Magento 2, the default search engine provides robust capabilities out-of-the-box. However, sometimes you may want to customize its behavior based on specific business requirements.

One common scenario is when a user searches for a term and gets only one result. Instead of displaying a list view with just one item, it would be more intuitive to automatically redirect them directly to the product page.

Understanding Magento 2 Search

Before we dive into customization, let’s quickly review how Magento 2 handles search:

  1. When a user submits a search query, the request hits the Magento_CatalogSearch\Controller_Result_Index controller.
  2. This controller processes the query and retrieves matching products using the searchResults method of the Catalogsearch model.
  3. If multiple results are found (more than one), it displays a list view page with pagination.
  4. If no results are found, it shows an empty search result page.

Implementing Single Result Redirect

To implement automatic redirection for single search results in Magento 2, you’ll need to override the core controller and alter its behavior:

  1. First, create a new module under app/code/YourVendor/SingleResultRedirect. This should contain the following files:

    • composer.json
    • registration.php
  2. In your module’s composer file, make sure to declare dependencies on Magento_CatalogSearch and Magento_Frontend:

"require": {
    "magento/module-catalog-search": "100.*",
    "magento/module-frontend": "100.*"
},
  1. Next, create the etc/di.xml file to override the controller:
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\CatalogSearch\Controller\Result\Index">
        <arguments>
            <argument name="resultLayout" xsi:type="string">your_vendor_single_result_redirect::result_layout</argument>
        </arguments>
    </type>
</config>
  1. Now, create the layout file app/code/YourVendor/SingleResultRedirect/view/frontend/layout/catalogsearch_result_index.xml:
<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="catalogsearch_result_index"/>
    <referenceBlock name="content">
        <block class="YourVendor\SingleResultRedirect\Block\Search\Result\Redirect" template="Magento_CatalogSearch::result.phtml"/>
    </referenceBlock>
</page>
  1. Finally, implement the redirect logic in app/code/YourVendor/SingleResultRedirect/Block/Search/Result/Redirect.php:
class Redirect extends \Magento\Framework\View\Element\Template
{
    public function getResults()
    {
        $results = $this->getData('search_results');
        if (count($results) === 1 && count($results)) {
            $result = reset($results);
            return [['url' => $result->getProductUrl(), 'name' => $result->getName()]];
        }
        return $results;
    }
}

Conclusion

Customizing Magento 2 search to handle single results gracefully involves a combination of module creation, layout updates, and block modifications. By following this approach, you can provide a seamless user experience that minimizes steps required for navigation.

Remember, while this solution works, it’s always recommended to thoroughly test any customizations before deploying them in a production environment. For more advanced search customizations and optimization techniques, consider exploring the official Magento 2 documentation or consulting with experienced Magento developers.

Happy coding!

[Backlink]: Check out our comprehensive guide on Magento 2 Theme Development for more insights into customizing Magento’s frontend.

Magento 2 Catalog Database Extensions

Our network