> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.resmarksystems.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Minimum and Maximum Quantities for Price Tiers

* [Summary](#3-summary)
* [How It Works](#2-how-it-works)
* [Configuration Examples](#2-configuration-examples)
* [Customer Experience](#2-customer-experience)
* [Setup Guidelines](#2-setup-guidelines)
* [Troubleshooting](#2-troubleshooting)

---

### Summary

The Min/Max/Increment feature provides greater control over how products are booked by allowing quantity limits at the price tier level. This is especially useful for participant-based products such as adventures, tours, or events where you need to manage how many people can join.

**With this feature, you can:**
* Set a minimum and maximum number of participants per price tier
* Define specific increments for bookings (ideal for "seat-based" products like kayaks, boats, or guided tours)

These settings help with smoother capacity management and prevent over- or under-booking.

---

### Setting Min/Max When Building a New Product

###### In the Pricing Tab

Define the price tier and set the minimum/maximum quantity. Then determine whether the price tier needs to increment based on the minimum quantity.

**Minimum Quantity:** The smallest quantity a customer can add to cart.
**Maximum Quantity:** The largest quantity a customer can add to cart.
**Increment:** Controls how the + and - buttons work in the shopping cart:
* **No:** Quantities increase/decrease by 1 when clicking + or -.
* **Yes:** Quantities increase/decrease by the minimum quantity value when clicking + or -.

![Pricing tab with min/max and increment settings](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250708-183502_1tfh1y.png)

###### Editing Min/Max Settings on an Existing Product

If you need to adjust min/max settings on an existing product:

1. Go to **Products > Click the product > Pricing tab > Manage Price Tiers**.
2. Make changes to the minimum/maximum quantities and adjust the increment setting if needed.
3. Click **Save**.

|| Note: Changes saved in the Pricing tab take effect immediately. When a customer attempts to add the product to their cart, the order will need to meet the updated criteria to complete the booking.

![Editing min/max settings on an existing product](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250708-183527_hzw9w.png)

---

### How It Works

Price Tiers control how customers can select quantities when adding products to their shopping cart. This feature enforces quantity limits and manages increment behavior for the quantity selector.

When a customer adds a product to their cart, the Price Tiers configuration controls:
* Minimum and maximum quantities they can select
* How the quantity increments when using the + and - buttons

**Quantity Selection**
Customers cannot manually enter quantities below the minimum or above the maximum. Any quantity entered outside the range will show an error.

**When Increment = No:**
* Clicking + increases quantity by 1
* Clicking - decreases quantity by 1
* Example: 1, 2, 3, 4...

**When Increment = Yes:**
* Clicking + increases quantity by the Minimum Quantity amount
* Clicking - decreases quantity by the Minimum Quantity amount
* Example: If Minimum Quantity = 3, then: 3, 6, 9, 12...

---

### Configuration Examples

###### Example 1: Min/Max Quantity with Increment Set to No

Minimum Quantity: 1
Maximum Quantity: 10
Increment: No

**Create:**
![Creating a price tier with increment set to no](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250701-204528_qqoo18.png)

**Edit:**
![Editing a price tier with increment set to no](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250701-204722_x0ak71.png)

**Result:** Customers can select 1 to 10 units. Quantities increment by 1 each click.

###### Example 2: Increment Quantity Set to Yes

Minimum Quantity: 5
Maximum Quantity: 50
Increment: Yes

**Create:**
![Creating a price tier with increment set to yes](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250701-205108_1tavkqc.png)

**Edit:**
![Editing a price tier with increment set to yes](https://storage.crisp.chat/users/helpdesk/website/-/5/1/c/e/51cecd630a16380/image-20250701-205133_1eo5lm8.png)

**Result:** Customers must buy at least 5 units, with a maximum of 50. Clicking + adds 5 more units each time (5, 10, 15, 20...).

---

### Customer Experience

**What customers see:**
* **Participant-based product selection:** Products with their own quantity controls.
* **Quantity selectors:** Each product shows the current quantity with - and + buttons.
* **Real-time validation:** Warning messages appear immediately when limits are exceeded.
* **Visual feedback:** Error messages appear in colored boxes to draw attention.

###### Error Messages

Customers will see error messages when:
* **Exceeding maximum quantity:** "The quantity will exceed the maximum quantity set of X for [Product Type]."
* **Below minimum quantity:** "A minimum of X is required for the [Product Type] price tier. Please review your order before continuing."

---

### Setup Guidelines

**When to use Increment = Yes:**
* Products sold in fixed pack sizes (e.g., sold by the seat)

**When to use Increment = No:**
* Individual items that can be purchased one at a time
* Products with flexible quantity needs

---

### Testing Your Configuration

Before making changes live:
1. Add the product to cart and verify the starting quantity.
2. Click the + button and confirm it increments as expected.
3. Click the - button and confirm it decrements as expected.
4. Try manually entering quantities outside your range.
5. Verify the error messages display correctly.