Change default controller in Magento

Change default controller in Magento

October 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Change default controller in Magento

Changing the Default Controller in Magento

As a seasoned developer working on the Magento platform, I often encounter common questions from fellow developers about altering default controller behavior. One such query deals with redirecting the default landing page to a custom controller within your own module.

Here’s how you can achieve this:

Understanding the Default Controller Behavior

By default, when you visit the root URL of your Magento store, it loads the Mage_Cms_IndexController and displays the “Home Page” content configured in the admin panel (System > Configuration > General > Web -> Default Pages section).

The controller loading sequence is as follows:

  1. The router matches the requested route to a controller.
  2. If no specific controller is matched, it falls back to Mage_Cms_IndexController.

Redirecting to Your Custom Controller

To redirect the default landing page to your custom controller (MyStore_Welcome_IndexController), you need to modify the routing configuration.

First, locate your module’s config.xml file, usually found at:

app/code/local/MyStore/Welcome/etc/config.xml

In this XML file, find or add a <routers> section that defines your custom route. It should look something like this:

<config>
    <modules>
        <MyStore_Welcome>
            <version>0.1.0</version>
        </MyStore_Welcome>
    </modules>

    <!-- Add this block -->
    <global>
        <routers>
            <mystore_welcome_index>
                <use>standard</use>
                <args>
                    <module>MyStore_Welcome</module>
                    <frontName>welcome</frontName>
                </args>
            </mystore_welcome_index>
        </routers>
    </global>
    <!-- End of added block -->
</config>

This configuration tells Magento to use your MyStore_Welcome module for the URL path you specify (in this case, /welcome).

Updating Your Router Configuration

Next, update your module’s router file:

app/code/local/MyStore/Welcome/controllers/Router.php

In this file, add or modify the addRoutes() method to include a new route for the root URL:

public function addRoutes($observer)
{
    $router = $observer->getEvent()->getRouter();
    $front = $observer->getEvent()->getFront();

    // Add your custom route for the root URL
    $front->addRoute('mystore_welcome_index',
        'welcome/index/index',
        array(
            'module' => 'MyStore_Welcome',
            'controller' => 'index'
        )
    );
}

This code instructs Magento to use your MyStore_Welcome_IndexController for the root URL.

Clearing Cache and Reindexing

After making these changes, you must clear the cache and reindex your data:

  1. Go to System > Cache Management in the admin panel.
  2. Select all cache types and click “Flush Magento Cache.”
  3. Then, go to System > Index Management.
  4. Click “Reindex All” to ensure your data is updated.

Conclusion

By following these steps, you can successfully redirect the default landing page of your Magento store to a custom controller within your own module. This allows you to create a unique welcome experience for your customers while maintaining the core functionality of the platform.

Remember that altering default behavior requires careful testing and consideration of the impact on other functionality in your store. Always ensure you have a backup before making significant changes.

For more advanced Magento development techniques, be sure to check out our comprehensive guides at Laravel Company.

Happy coding!

Database Extensions Admin Configuration

Our network