Magento form post action to custom controller not working - wrong routing, but why?

Magento form post action to custom controller not working - wrong routing, but why?

October 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento form post action to custom controller not working - wrong routing, but why?

Solving Magento Form Post Action Routing Issues

When working with Magento forms, especially built-in forms like the Contact form, you may encounter routing issues when submitting the form data to your custom controller action. This often happens due to incorrect frontname configuration or module name mismatches in the URL. Let’s dive into why this issue occurs and how you can resolve it.

Understanding the Issue

In your case, the contact form is using a specific frontname contact for its page identifier. When you submit the form with the default action attribute set to contactform/index/sendcontactmail, Magento appends the frontname to the URL during routing, resulting in an incorrect posting destination like this: http://www.domain123.com/contact/contactform/index/sendcontactmail.

This is because Magento follows a specific routing pattern for pages with frontnames. The issue lies in the module name (contactform) not matching the controller prefix defined in your module’s etc/routes.xml configuration.

Analyzing Your Current Configuration

Let’s assume your contactform/etc/routes.xml file looks something like this:

<config xmlns:core="urn:magento:framework:app etc/config">
    <router id="standard">
        <route frontName="contactform" id="contactform" module="Magento_ContactForm">
            <action id="index/sendcontactmail" module="Magento_ContactForm" controller="IndexController" method="sendcontactmail"/>
        </route>
    </router>
</config>

In this configuration, the frontName is set to contactform, which doesn’t match the frontname of your contact page. This mismatch causes Magento to append the wrong module name (contactform) to the URL during routing.

Resolving the Routing Issue

To fix this problem, you have a few options:

  1. Change the Frontname: Update the frontName in your Magento configuration for the Contact page from contact to match your contactform module name. This ensures that when submitting the form, the correct frontname is used.

    Update your app/code/Magento/Contact/etc/config.xml file:

    <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Config etc/config.xsd">
        ...
        <landing>
            <contact>
                <group>customer</group>
                <class>Magento_Contact</class>
                <page_id>contact_index_index</page_id>
                <frontend_label translate="true">Contact Us</frontend_label>
                <template>Magento_Theme::contact.phtml</template>
                <root_template>Magento_Theme::root contact-root.phtml</root_template>
                <layout_handle>customer_account_contact</layout_handle>
                <block_class>Magento\Customer\Block\Account\Contact</block_class>
                <block_type>Magento\Customer\Block\Account\Contact</block_type>
                <controller_action>contact/index/index</controller_action>
                <frontname>contactform</frontname> <!-- Update this line -->
            </contact>
        </landing>
        ...
    </config>
    
  2. Update the Form Action: Alternatively, you can update the form’s action attribute to directly reference your custom controller action without including the frontname.

    Update your contact form layout XML file (usually located in app/design/frontend/{package}/{theme}/Magento_Contact/layout/contact_index_index.xml):

    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
        ...
        <body>
            <referenceContainer name="content">
                <block class="Magento\Contact\Block\ContactForm" name="contactform_block">
                    <action method="setTemplate">
                        <argument name="template" xsi:type="string">Magento_Contact::contact.phtml</argument>
                    </action>
                    <block class="Magento\Framework\View\Element\Form" cacheable="false">
                        <attribute name="action" value="/index/sendcontactmail"/> <!-- Update this line -->
                        ...
                    </block>
                </block>
            </referenceContainer>
        </body>
    </page>
    

Best Practices for Magento Form Routing

To avoid similar issues in the future, follow these best practices:

  • Ensure your frontName in the module’s configuration matches the frontname used in your layout XML files.
  • Avoid using hardcoded URLs in your form actions. Instead, use the form’s <action> attribute to reference your custom controller action directly.
  • Always validate and test your form routing after making any changes.

Conclusion

Solving Magento form post action routing issues requires a thorough understanding of Magento’s URL routing system and proper configuration of frontnames and module names. By updating either the frontName in your configuration or the form’s action attribute, you can resolve the incorrect URL posting destination issue.

Remember to test your changes thoroughly to ensure the form submits correctly to your custom controller action without any 404 errors. If you need further assistance with Magento development or want to learn more about best practices, feel free to explore our resources at Laravel Company.

Happy coding!

Extensions Configuration Email Errors

Our network