Magento new basic shipping method not showing in frontend

Magento new basic shipping method not showing in frontend

August 27, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento new basic shipping method not showing in frontend

Solving Magento Shipping Method Issues

If you’re facing difficulties where your newly created shipping method isn’t showing up on the frontend checkout despite proper backend configuration, this guide will walk you through troubleshooting and resolving the issue step-by-step.

Understanding the Problem Landscape

There could be several reasons for a shipping method to not appear on the frontend:

  1. Incorrect Module Configuration: A missing or incorrectly configured sysconfig.xml file in your module.
  2. Incompatible Extensions: Conflicts with other extensions installed, especially if they also deal with shipping options.
  3. Missing Dependencies: Required dependencies for the shipping method aren’t properly set up.

Step-by-Step Diagnosis

Check Module Configuration Files

The first step is to verify that your module’s configuration files are correctly set up. The sysconfig.xml file should include the following structure:

<config>
  <modules>
    <Your_Module_Name>
      <version>1.0</version>
    </Your_Module_Name>
  </modules>
  <default>
    <carriers>
      <your_shipping_method_name>
        <active>1</active>
        <model>your_module_name/carrier_your_shipping_method</model>
        <name>Your Shipping Method Name</name>
        <title>Your Shipping Method Title</title>
        <methods>
          <method>
            <name>flatrate</name>
            <title>Flat Rate</title>
            <price>10.95</price>
            <sort_order>26</sort_order>
          </method>
        </methods>
      </your_shipping_method_name>
    </carriers>
  </default>
</config>

Ensure that the <active> tag is set to 1, and the <model> points correctly to your module’s carrier class.

Check for Extension Conflicts

Since you mentioned having another extension related to warehouses, it might be interfering with your new shipping method. To diagnose this:

  1. Deactivate the other warehouse-related extension temporarily.
  2. Clear all Magento caches using php bin/magento cache:clean and php bin/magento cache:flush.
  3. Check if the shipping method appears on the frontend now.

Verify Module Dependencies

Make sure that your module has proper dependencies set up in its composer.json file:

"require": {
    "magento/framework": "100.*",
    "magento/module-checkout": "100.*"
}

The framework dependency is crucial for most Magento modules, and the checkout module should be required if your extension handles shipping options.

Best Practices to Avoid Future Issues

To prevent such issues in the future:

  • Always test new shipping methods on a staging environment first before deploying to production.
  • Use version control systems like Git to track changes and revert if needed.
  • Regularly clear Magento cache and run bin/magento setup:upgrade after installing new modules.

Conclusion

Resolving Magento shipping method issues often involves a combination of checking configuration files, ensuring proper dependencies are set up, and verifying that there are no conflicts with other extensions. By following the steps outlined here, you should be able to pinpoint the cause of the issue and resolve it effectively.

Remember, Magento’s documentation is an excellent resource for understanding how shipping methods work under the hood: https://devdocs.magento.com/swagger/#/carriers/carrier_v1.

If you find yourself needing further assistance or custom development for your Magento store, feel free to reach out to the experts at Laravel Company. Our team is always ready to help you optimize your e-commerce platform.

Checkout Extensions Admin Configuration

Our network