# mageplaza/module-multi-flat-rates

> Magento 2 Multi Flat Rates extension

`composer require mageplaza/module-multi-flat-rates`

Canonical URL: https://packagento.com/mageplaza/module-multi-flat-rates

## At a glance

- **Vendor**: mageplaza (https://packagento.com/mageplaza.md)
- **Latest version**: 1.1.2 — released 2021-09-20
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/mageplaza/module-multi-flat-rates and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require mageplaza/module-multi-flat-rates:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento 2 Multi Flat Rates extension

## README


Native Magento 2 only supports **one flat rate shipping** which can lead to difficulty for stores in defining the best price for delivering products to customers in different countries.  

[Magento 2 Multiple flat rate shipping](https://www.mageplaza.com/magento-2-multi-flat-rates/) is a must have for many online stores, especially international brands which deliver their products worldwide. Offering buyers different flat rates to select makes shopping easier and convenient for customers. Besides, this also helps stores manage shipping methods better.

[![Latest Stable Version](https://poser.pugx.org/mageplaza/module-multi-flat-rates/v/stable)](https://packagist.org/packages/mageplaza/module-multi-flat-rates)
[![Total Downloads](https://poser.pugx.org/mageplaza/module-multi-flat-rates/downloads)](https://packagist.org/packages/mageplaza/module-multi-flat-rates)


### 1. Flat Rates Shipping Documentation

- [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)
- [User guide](https://docs.mageplaza.com/multi-flat-rates/index.html)
- [Contribute on Github](https://github.com/mageplaza/magento-2-multi-flat-rates/)
- [Get Support](https://github.com/mageplaza/magento-2-multi-flat-rates/issues)

### 2. FAQs

- **Q: I got an error: Mageplaza_Core has been already defined**

- A: Read solution: https://github.com/mageplaza/module-core/issues/3

### 3. How to install Magento 2 Multi Flat Rates Shipping extension

#### Install via composer (recommend)

Run the following command in Magento 2 root folder:

With Marketing Automation (recommend):
```
composer require mageplaza/module-multi-flat-rates mageplaza/module-smtp
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```

Without Marketing Automation:
```
composer require mageplaza/module-multi-flat-rates
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```
### 4. Multiple Flat Rates Shipping features

#### 5 multiple flat rate shipping

**Magento 2 Multi flat rate shipping extension** allows store admins to add up to 5 other shipping rates. Admins are free to give a shipping flat rate a name and/or a title to help buyers distinguish it with others on Cart page and Checkout page. 

Each flat rate can be turned on/off easily on the backend. A set of configuration options for price, sort order, applicable countries, and error message are also ready to be selected.

#### Sort multi flat rates neatly

As a store may want to have more than only one flat rate shipping, **Multiple Flat Rates Shipping** should be in a certain order. Admins can choose this order by sorting every shipping rate on the backend. 

#### Multi flat rate visibility

**Each flat rate shipping** can be applied on a restricted number of countries or all allowed countries depending on the settings on backend. 

Admins can multiple select countries to allow buyers in those countries to choose a specific shipping flat rate.

#### Error message

Buyers who are not in applicable countries will not be allowed to select that shipping flat rate. In this case, admins can set an error message to inform buyers. This message can be enabled/disabled and changed easily on the backend.

#### Compatible with One Step Checkout

**Magento 2 Multi Flat Rates Shipping extension** is amazingly compatible with [Mageplaza One Step Checkout](https://www.mageplaza.com/magento-2-one-step-checkout-extension/) which delivers the best shopping experience for your customers. 


### 5. How to configure multiple flat rate shipping on Magento 2

From your Magento admin panel, follow this route: `Stores > Settings > Configuration > Sales > Shipping methods`. Then, click on `Flat rate #1 - Flat rate #5` to configure these 5 shipping rates.

![Magento 2 Multiple Flat Rates Shipping](https://i.imgur.com/yiEzfE6.png)

#### Configure flat rate shipping #1

![Magento 2 Multiple Flat Rates Shipping module](https://i.imgur.com/s3kpRye.png)

- **Enable**: Select Yes to run Flat Rate #1
- **Method Name**: This is the name the flat rate #1 that is displayed on the View cart page and the Checkout page. If you leave this field blank, the rate will have no name on these two pages.
- **Price**: This is the shipping fee of Flat Rate #1 which is displayed on the frontend. If you leave this field blank, the price will be automatically set $0.00 as default.
- **Sort Order**: This is the order of Flat Rate #1 on the flat rates list displayed on the frontend. For example: If Sort Order = 1 is set for Flat Rate #1 while Sort Order = 2 is set for Flat Rate #2, Flat Rate #1 will stand above Flat Rate #2 on the frontend.

![Magento 2 Multiple Flat Rates Shipping extension](https://i.imgur.com/sgrBrOz.png)


- **Title**: This is the title of the flat rate which is displayed on the Cart page and Checkout page. If you leave this field blank, no title is displayed.

![Configure Multiple Flat Rates Shipping for Magento 2](https://i.imgur.com/bIfptAy.png)


- `Ship to Applicable Countries`: 
  - Select All Allowed Countries to apply the rate on all available countries.
  - Select Specific Countries to apply the rate on the countries which are selected on the field Ship to Specific Countries.

![Configure Magento 2 Multiple Flat Rates Shipping](https://i.imgur.com/GWOQSeW.png)

- `Ship to Specific Countries`: Select one or several countries which the rate is applied for.
- `Display Error Message`: Enter an error message which is displayed to buyers when the rate is not available. If you leave this box blank, the default message will be displayed: `Sorry, but we can’t deliver to the destination country with this shipping module`. This error message is displayed only when `Show Method if Not Applicable` = Yes
- `Show Method if Not Applicable`: Select Yes to display all shipping methods even when they do not belong to any applicable countries.

Similarly, admins can add up to 5

_(README truncated for .md surface. Full README on https://packagento.com/mageplaza/module-multi-flat-rates.)_

## Changelog

CHANGELOG: https://www.mageplaza.com/releases/multi-flat-rates

## Recent Versions

| Version | Released |
|---|---|
| 1.1.2 | 2021-09-20 |
| 4.0.1 | 2021-09-20 |
| 4.0.0 | 2021-03-23 |
| 1.1.1 | 2020-02-19 |
| 1.1.0 | 2019-07-25 |
| 1.0.0 | 2018-10-18 |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["mageplaza/module-multi-flat-rates"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

mageplaza is a Magento 2 vendor on Packagento. See https://packagento.com/mageplaza.md for their full catalogue.