---
title: "Minimum Order Restriction"
description: "The Minimum Order Restriction app lets you set rules that must be satisfied before a customer can proceed from the cart to checkout."
url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/minimumorder"
markdown_url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/minimumorder.md"
last_updated: "2026-10-31T23:38:40+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Apps and Extensions"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions"
  - title: "Apps"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps"
  - title: "Minimum Order Restriction"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/minimumorder"
---

# Minimum Order Restriction

The Minimum Order Restriction app lets you set rules that must be satisfied before a customer can proceed from the cart to checkout. When any rule is violated, the customer is redirected back to the cart with a plain-English warning message telling them exactly what needs to change. You can enforce a price floor, quantity limits, pack-size requirements, and category-specific spending thresholds — all from a single plugin.

---

## Purchase and Download

The **Minimum Order Restriction** app is a separate add-on available from the [Minimum Order Restriction](https://www.j2commerce.com/extensions/apps/min-order-restriction). It is not included with the core J2Commerce 6 component.

**Step 1:** Go to the [J2Commerce website](https://www.j2commerce.com/extensions) -> **Apps**.

**Step 2:** Locate the **Minimum Order Restriction** app -> click **View Details** -> **Add to cart** -> **Checkout**.

**Step 3:** Go to **My Downloads** under your profile menu at the top right corner and search for the app. Click **Available Versions** -> **View Files** -> **Download**.

## Install the App

You can install this **Minimum Order Restriction** App using the Joomla installer. The following steps help you with a successful installation.

In the Joomla admin, go to **System -> Install -> Extensions**

Upload the plugin `plg_j2commerce_app_minimumorder.zip`file or use the Install from URL option.

![Install extensions](https://docs.j2commerce.com/images/docs/v4/assets/app%20install1%20%281%29%20%281%29.webp)

## Enable the App

Once you have installed the App, you will need to enable it. There are **two** ways you can access the extension.

**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Apps**

**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Apps**

![shipping method](https://docs.j2commerce.com/images/docs/shared/accordions-app.webp)

Look for **Minimum Order Restriction**, click the **X,** and it will turn into a green checkmark. It is now enabled and ready for setup.

![Joomla Apps list searched for min, with the Minimum Order Restriction for J2Commerce status icon highlighted as a green checkmark](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-enable.webp)

---

## Configure the App

Click the **Minimum Order Restriction** title (next to the green checkmark) to open the settings screen.

> **Tip:** Click the **Toggle Inline Help** button on any app you install to see a description below each field directly in the admin panel.

![Minimum Order Restriction settings with Toggle Inline Help highlighted and the Restricted Categories help text shown on the Category-Based Settings tab](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-toggle.webp)

## Overview of the Three Restriction Modes

The plugin has three independently enabled restriction modes. Each mode has its own on/off toggle, so you can use one, two, or all three at the same time.

- **Price-Based:** Cart subtotal or order total versus a minimum amount
- **Quantity-Based:** Total cart quantity or per-item quantity versus minimum/maximum values
- **Category-Based:** Combined value of items from specific Joomla content categories

Checks run in order: price first, then quantity, then category. The customer is redirected on the first failure — they will not see multiple errors at once.

---

### Price-Based Restriction tab

![Minimum Order Restriction settings, Price-Based Settings tab highlighted: Enable Price-Based Restriction Yes, Calculation Type Subtotal, Minimum 0](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-price.webp)

This mode blocks checkout when the cart value is too low.

**Enable price-based restriction:** Set to **Yes**.

**Calculation Type**:

- **Subtotal:** The cart subtotal before taxes, shipping, and discounts
- **Total:** The final order total (after taxes, shipping, and discounts)

If you choose **Total**, an extra field appears: **Include Discount in Order Total?**

- **Include Discount**: The minimum is compared against the total after coupons
- **Exclude Discount:** The minimum is compared against the total before coupons are subtracted

**Minimum Subtotal / Total**. Use the same currency your store displays. For example, enter `50` for a $50 minimum.

**Debug Mode:** Writes every blocking decision to the Joomla log file

### Common use cases

- **Wholesale store:** Set a $100 minimum subtotal so that small retail-quantity orders are automatically blocked.
- **Free shipping threshold enforcement:** Pair a minimum total with your free shipping rule — if the total is under the free shipping threshold, customers are nudged to add more items before proceeding.

---

### Quantity-Based Restriction tab

![Minimum Order Restriction settings, Quantity-Based Settings tab highlighted: both switches Yes, Per-Item Quantity, Minimum Quantity 0, Maximum Quantity 3](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-quantity.webp)

This mode blocks checkout based on how many units are in the cart.

**Enable quantity-based restriction:** Activates this product's own limits. Must be set to **Yes** for the fields below to take effect.

**Quantity Must Be a Multiple of Minimum?** Pack-size enforcement (optional). Set to **Yes** if you sell in packs. When enabled, the quantity must be an exact multiple of the minimum. For example, with minimum set to `6`, allowed quantities are 6, 12, 18, 24, and so on. Any other quantity triggers the warning and redirects to cart. This applies to whichever scope you chose in Step 2 — cart total quantity or per-item quantity.

**Quantity Restriction Applies To:**

- **Total Cart Quantity:** The combined quantity across all line items in the cart
- **Per-Item Quantity:** The quantity of each individual line item

**Set minimum and maximum quantities:**

- **Minimum Quantity** — the smallest allowed quantity. Leave at `0` to skip the minimum check. Minimum units of this product required in the cart at checkout. Set to `0` to skip.
- **Maximum Quantity** — the largest allowed quantity. Leave at `0` to skip the maximum check. Maximum units of this product allowed in the cart at checkout. Set to `0` to skip.

### Common use cases

- **Minimum purchase quantity of 2:** Set scope to **Total Cart Quantity**, minimum to `2`, maximum to `0`.
- **Bulk packs only:** Set scope to **Per-Item Quantity**, minimum to `6`, maximum to `0`, and enable the multiple requirement.
- **Event ticket cap:** Set scope to **Total Cart Quantity**, minimum to `1`, maximum to `10` to limit large bulk purchases at checkout.

---

### Category-Based Restriction tab

![Minimum Order Restriction settings, Category-Based Settings tab highlighted: Restricted Categories empty, Minimum Category Order Value 0](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-category.webp)

This mode blocks checkout when items from specific Joomla content categories do not reach a minimum combined value. It is useful for stores that carry products across multiple categories and want to require a minimum spend within a particular product range.

**Restricted Categories:** Select the field and choose one or more Joomla content categories. The check automatically includes products from any descendant categories of those you select — you do not need to list child categories individually. Joomla content categories that count toward the minimum

**Minimum Category Order Value**: The plugin adds up the line totals (quantity multiplied by unit price) for every item whose article belongs to the selected categories. If that combined value is below the minimum, checkout is blocked. Minimum combined value of items from those categories

### How the value is calculated

- Only items from `com_content` (Joomla articles) are counted.
- The unit price used is the base item price plus any option add-ons.
- If the cart contains no items from the restricted categories at all, the check is skipped — the customer is not blocked.
- Descendant categories are matched by walking up the category tree up to 20 levels deep.

A store sells general merchandise and specialty tools. They want customers to spend at least $50 on specialty tools before checkout. Configure the Specialty Tools category here and set the minimum to `50`. Orders with no specialty tool items proceed normally; orders with specialty tools totaling under $50 are blocked.

---

## Per-Product Quantity Override

![Product edit screen, Apps tab highlighted, with Minimum Order Restriction expanded: Product Minimum Quantity 0, Product Maximum Quantity 2](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-product.webp)

Any individual product can opt into its own minimum and maximum quantity rules. When a product uses its own limits, it is also exempt from the global per-item maximum set in the Quantity-Based Settings tab.

1. Go to **J2Commerce** -> **Catalog** -> **Products**.
2. Open the product you want to configure.
3. Click the **Apps** tab in the product editor.
4. Find the **Quantity Restriction** section provided by the Minimum Order Restriction plugin.

### When to use per-product overrides

- A product is sold individually and cannot be purchased in bulk — set maximum to `1`.
- A component or part requires purchasing at least 2 units — set minimum to `2`.
- A limited-edition item should not override general store limits but needs its own cap — enable the override and set only the maximum.

The per-product check runs as part of the quantity restriction phase. If the global quantity restriction is disabled in the plugin settings, per-product overrides are still enforced.

---

## Frontend Checkout View

![Cart drawer on a product page with the quantity set to 5 highlighted and a warning that the maximum restriction of 3 for the product was reached](https://docs.j2commerce.com/images/docs/shared/min-order-restrict-checkout.webp)

## What Changed from J2Store

If you used Minimum Order Restriction with J2Store v4, here is what is different in J2Commerce 6:

- **No legacy Admin Apps view.** The plugin no longer adds a tab to the old J2Store backend apps area. Configuration is done entirely through the standard Joomla Plugin Manager or the **J2Commerce** -> **Apps** screen.
- **XML-based product fields.** Per-product minimum/maximum fields are rendered via Joomla's form API. There is no jQuery dependency for displaying these fields in the product editor.
- **Parameterised SQL.** All database queries use bound parameters — no raw string concatenation.
- **Per-product max exemption works correctly.** In J2Store v4, enabling a per-product override did not always exempt the product from the global per-item maximum. In J2Commerce 6, enabling **Enable Per-Product Quantity Restriction** on any product correctly skips the global per-item maximum check for that product, even when the product itself has no maximum set.

---

## Troubleshooting

### Customers can still check out below the minimum amount

**Possible cause:** The plugin is installed but not enabled.

**Solution:**

1. Go to **J2Commerce** -> **App**
2. Search for **Minimum Order Restriction**.
3. Confirm the status is green (enabled).
4. Open the plugin and check that **Enable Price-Based Restriction** is set to **Yes** and that **Minimum Subtotal / Total** is greater than `0`.

### The amount check passes but the cart total looks correct

**Possible cause:** You have **Calculation Type** set to **Total** and the order total includes taxes or shipping that push it above the threshold, even though the product subtotal is lower.

**Solution:** Switch **Calculation Type** to **Subtotal** if you want the check to run against product prices only, before taxes and shipping are added.

Alternatively, if you are using the **Total** calculation and coupons apply, check the **Include Discount in Order Total?** setting. With **Include Discount** active, a coupon can reduce the total below the threshold. Switch to **Exclude Discount** if you do not want coupons to affect this check.

### The quantity multiple check is not triggering

**Possible cause:** **Quantity Must Be a Multiple of Minimum?** is set to **Yes**, but **Minimum Quantity** is `0`.

**Solution:** Enter a value greater than `0` in **Minimum Quantity**. The multiple check requires a non-zero minimum to divide by.

### Category restriction never blocks checkout

**Possible cause 1:** The products in the cart do not use Joomla articles as their source. The category restriction only counts items sourced from `com_content`.

**Possible cause 2:** No categories are selected in the **Restricted Categories** field, or the minimum value is `0`.

**Solution:** Open the plugin, go to **Category-Based Settings**, confirm that at least one category is selected and that **Minimum Category Order Value** is greater than `0`.

### Finding the debug log

When **Debug Mode** is set to **Yes**, the plugin writes a log entry every time it blocks a checkout. The log file is located at:

```
[joomla-root]/administrator/logs/plg_j2commerce_app_minimumorder.php
```

Each entry includes the reason the checkout was blocked. Review this file if a restriction appears to be firing incorrectly or not firing at all. Disable Debug Mode in production once you have confirmed the rules are working correctly.

---

## See Also

- [Apps and Extensions Overview](https://docs.j2commerce.com/index.php?option=com_content&view=category&id=47)