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

Disabling & Uninstalling the ShipperHQ Extension for Magento

Step-by-step process to safely disable or uninstall ShipperHQ extension in Magento

Overview

Sometimes you need to disable the ShipperHQ extension in Magento, especially if it's causing conflicts on your site. You may also need to completely uninstall our extension on certain occasions, such as during an upgrade. Below, you'll find steps for both processes. 

If you encounter any issues with the configuration, please contact us for assistance.

💡 Caution: Some attributes used by ShipperHQ are also used by WebShopApps extensions. If you have WebShopApps extensions that you still need, do not delete those attributes.

This guide assumes that you have a working knowledge of MySQL.

Table of Contents

Magento 2

How to Disable ShipperHQ Modules

From the command line, disable the modules using:

php bin/magento module:disable --clear-static-content ShipperHQCommon ShipperHQLogger ShipperHQ_Shipper

If you have any optional modules enabled, disable them similarly:

php bin/magento module:disable --clear-static-content ShipperHQPickup ShipperHQOption ShipperHQ_Calendar

Lastly, run the standard cleanup commands:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento indexer:reindex
php bin/magento cache:clean

Composer Uninstaller

As of version 20.35.0, uninstall the modules using Composer:

php bin/magento module:uninstall -r ShipperHQ_Shipper

This WILL remove your ShipperHQ attributes and data from your database. Omit the "-r" parameter if you want to keep your data. If you encounter an error like:

Troubleshooting
Class "ShipperHQ\Shipper\Model\Carrier\Shipper" does not exist

You may need to run this SQL manually due to an issue preventing all ShipperHQ data removal during uninstall:

DELETE FROM core_config_data WHERE value LIKE 'ShipperHQ\\Shipper\\Model\\Carrier\\Shipper';

Remember to refresh the cache after running this SQL. Learn more about updating to 20.35.0 or newer in our Installation Article. 💡

How to Manually Uninstall the ShipperHQ Module

Follow these steps:

  1. Disable the cache (if enabled) and compiler (if enabled).
  2. Edit the eav_attribute table and change is_user_defined to 1 for all ShipperHQ attributes.
  3. Remove all ShipperHQ attributes from all attribute sets. The attributes to remove include: List of ShipperHQ Attributes to remove
  4. Run: composer remove shipperhq/module-logger
  5. Run: composer remove shipperhq/module-shipper
    1. If you have the optional modules installed then also run:
      1. composer remove shipperhq/module-option
      2. composer remove shipperhq/module-pickup
      3. composer remove shipperhq/module-calendar
  6. Run: php bin/magento setup:upgrade
  7. Run: php bin/magento setup:di:compile (if the compiler is enabled).
  8. Remove any references to shipperhq from the core_config_data MySQL database table.
  9. Verify removal on admin/frontend.
  10. All attributes from step 2 can be removed if no longer needed.
  11. Enable cache (if previously enabled).
  12. If Redis is installed, flush its caches: redis-cli FLUSHALL
  13. Retest in Private Browsing/Incognito Mode to ensure your browser isn't caching the checkout.