Skip to content
Visit ShipperHQ.com
  • There are no suggestions because the search field is empty.

Troubleshooting Matrixrates

Resolve common issues with MatrixRates shipping method configurations and CSV uploads

Table of Contents

Overview

Experiencing issues with Matrixrates? We've compiled common troubleshooting tips to help you navigate and resolve typical problems. 😊 Follow these steps to get your shipping methods working smoothly.

No Shipping Methods are Available

By default, no error message appears when shipping methods or rates are unavailable. To enable this, set "Show Method if Not Applicable" to "Yes" in Stores > Configuration > Sales > Shipping Methods > Matrix Rate. An error message will display when no methods/rates are available.

  • Your CSV file might be corrupt or not uploaded. Check the database table webshopapps_matrixrate to ensure it's populated. Verify that your CSV is formatted correctly.
  • Your cart scenario may not match any entries in the CSV file. Ensure your CSV file includes relevant conditions. Use an asterisk ‘*’ instead of '1' for fields marked 'greater than.'
  • Simplify your CSV. Gradually reduce the number of rules to identify which one prevents rates from returning. Check example pages for discrepancies.
  • Ensure the weights/prices/quantities in your CSV are valid for your cart products. The extension doesn't interpret units; it only looks at numeric values.
  • All products must have a weight. Although a weight smaller than 0.001 will still work, zero weights won't match CSV conditions requiring values greater than zero.

CSV Not Uploading Successfully

  • Ensure the CSV is formatted correctly.
  • If you encounter an error stating The file "/var/tmp/..." doesn't exist, it might be a PHP configuration problem, requiring attention from your developer or hosting provider.
  • If "0 Rows imported" occurs, this can be due to incorrect file formatting.
  • For large CSV files, ensure your server handles large uploads by modifying php.ini. Adjust upload_max_filesize and post_max_size to values larger than your CSV file size. For instance, a 20MB CSV should warrant settings beyond 30M.

State/Region Code Invalid

The "State/Region" column in the CSV refers to Magento's region codes stored in the directory_country_region table. Ensure these codes are available. Developers can add missing codes if needed.

Installation

Installation hiccups often relate to incorrect permissions. Refer to the Pre-installation Ownership and Permissions guide. Switching to manual installation might indicate other issues, such as incorrect file permissions. Explore the Installation guide for manual steps if needed.

Base Table or View Not Found

This error suggests SQL installation failure. Follow this document to address the issue.

Further Reading

For reported issues, incompatibilities, unsupported features, and fixes, visit the public Github repo. Keeping your Magento and extensions up-to-date usually resolves bugs or extension changes.