Shipping Restrictions - Magento 2

Firefox user notice:

Please use another web browser to view this document.

Sorry for the inconvenience.

Magento 2 Shipping Restrictions enhances native Magento functionality meant to specify shipping methods at checkout against a variety of criteria. The extension adds the Customer Group criterion. Now vendors are able to specify which shipping methods are to be shown at checkout depending on shopper's belonging to a particular customer group. 

Compatibility: Magento Open Source 2.3.X - 2.4.X, Magento Commerce 2.3.X - 2.4.X 

Product Page

Thank you for choosing Aheadworks!

Installing Magento 2 Shipping Restrictions

Command Line InstallationComposer Installation

1. Backup your web directory and store database

2. Download the Shipping Restrictions installation package

 3. Upload contents of the Shipping Restrictions installation package to your store root directory

 4. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder


php -f bin/magento module:enable Aheadworks_ShippingRestrictions


php -f bin/magento setup:upgrade


php -f bin/magento setup:static-content:deploy

5. Flush store cache; log out from the backend and log in again

Make sure the installation is done from the FTP administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed.

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following command:

composer config repositories.aheadworks composer

On successful execution of the command you will be able to use the composer to install the extensions.

To install the extension:

2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

 3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-shipping-restrictions

if you need to install a specific version, run this command:

composer require aheadworks/module-shipping-restrictions:<version>

Specify the version of the extension in <version>

When prompted, enter Public Key (Username) and Private Key (Password):

Both Public Key (Username) and Private Key (Password) can be found in the Composer Access page in your personal account on our site:
Note that the password will not be displayed for security reasons.

4. Enable the extension:

php -f bin/magento module:enable Aheadworks_ShippingRestrictions

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

To upgrade the extension:

5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:
composer update aheadworks/module-shipping-restrictions
Updater per version:
composer require aheadworks/module-shipping-restrictions:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Introducing the Magento 2 Shipping Restrictions

Shipping Restrictions for Magento 2 is a tool to specify shipping methods to be available on the checkout page with regard to customer's belonging to a particular customer group, as pre-configured in the store.

What is special in Aheadworks Shipping Restrictions for Magento 2 in comparison with the native Magento functionality:

  • Shipping methods restricted at checkout
  • Customer groups to restrict shipping methods
  • Support of Multishipping
  • All Groups and Multiselect options for customer groups selection
  • Integration with One Step Checkout, Company Accounts

Using Magento 2 Shipping Restrictions

Configuration Options

The extension comes as a set of single-type configuration facilities available at Stores > Configuration > Sales > Shipping Restrictions. The page will feature the list of all shipping methods saved on the store.

Learn more on configuring shipping methods in the official Magento 2 user guide.

To set restrictions, unfold the options of the shipping method by clicking the name of the method, and scroll down to the Allowed for Selected Customer Groups Only parameter.

The Allowed for Selected Customer Groups Only parameter comes as a check-list of all customer groups available on the store. To add/delete customer groups, proceed to Customers > Customer Groups. The official Magento 2 manual will instruct you on how to do that. Name your custom groups meaningfully, so that you later you have meaningful restrictions on shipping.

By default all customer groups are given same rights to all shipping methods. It means that all shipping methods are open to all groups. When in the default mode, the list of groups will come inactive, greyed-out, All Groups selected.

To specify the groups which will have access to the chosen shipping method, click on the name of the group. It will then get highlighted in blue. To select multiple groups, press the CTRL button on the keyboard and select as many groups as you need. Multiselect works on mobile devices too.

The All Groups option will apply restrictions to all groups presented on the list.

Sample restrictions:

B2C customers will be thankful for discounted or free shipping, B2B clients will appreciate alternatives to manage bulky orders and complex delivery needs. 

Only those methods of shipping which have been pre-configured herein will feature on the Checkout page. Cutting the list short and suggesting selected options for various customer groups will save the time of customers, and will suggest them you know their needs and preferences.


The Magento 2 Company Accounts module allows creating company accounts and assigning them to particular customer groups. Those will be your B2B clients, and thereby they may well need specific shipping methods, different to those of general customers. 

The Magento 2 One Step Checkout extension enhances the native Magento checkout functionality for best user experience. It will feature the specified for the customer shipping methods in its usual, enhanced, way.

Uninstalling Shipping Restrictions

Manual Removal

1. Disable the module by executing the following commands:

php bin/magento module:disable Aheadworks_ShippingRestrictions
php bin/magento setup:upgrade

2. Remove the extension files from the following folder:


Automatic Removal (via Composer)

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_ShippingRestrictions

Product Page

Need Customization?

You can always find the latest version of the software, full documentation, demos, screenshots, and reviews on
License agreement:
Contact Us:
Copyright © 2021 Aheadworks Co.