Back to Help Center
MinimumCart

MinimumCart Documentation

Help & guides for MinimumCart

What is MinimumCart?

MinimumCart is a Shopify app that lets you set minimum order amounts and display a beautiful progress bar guiding customers to checkout. Block unprofitable orders, increase average order value, and protect your margins.

Perfect for stores that need to:

  • Protect profit margins
  • Cover shipping costs
  • Set wholesale minimums
  • Increase average order value
  • Block low-value orders
  • Encourage upsells

Quick Start Guide

Step 1: Create Your First Rule

  1. Open MinimumCart from your Shopify admin (Apps → MinimumCart)
  2. Click "Create Rule" from the dashboard
  3. Enter a name (e.g., "Standard Minimum")
  4. Select minimum type: Cart Total ($), Item Quantity, or Cart Weight
  5. Enter the minimum value (e.g., 50 for a $50 minimum)
  6. Customize the messages (or use the defaults)
  7. Click "Save"

Step 2: Add the Block to Your Theme

  1. Go to Online Store → Themes in your Shopify admin
  2. Click "Customize" on your active theme
  3. Use the page selector to navigate to the Cart page template
  4. Click "Add block" in the template section
  5. Select "MinimumCart" from the app blocks
  6. Position the block where you want the progress bar to appear
  7. Click "Save"

Step 3: Test It

  1. Visit your store's cart page
  2. Add a product to your cart
  3. You should see the progress bar showing progress toward the minimum
  4. Try to checkout — the button should be disabled if the minimum is not met

Features

Free Plan

  • Single minimum order rule
  • Visual progress bar with real-time updates
  • Custom messaging with dynamic variables
  • Checkout blocking
  • Top/bottom/inline positioning
  • Multi-language support (9 languages)
  • Cart page support

Pro Plan

$4.99/mo

Everything in Free, plus:

  • Unlimited rules
  • Customer tag targeting
  • Collection-based rules
  • Quantity & weight minimums
  • Product suggestions
  • Cart drawer support
  • Rule scheduling
  • Analytics dashboard
  • Custom colors
  • Remove branding
  • Priority support

Creating Rules

Rule Types

Cart Total ($)

Require a minimum dollar amount

Best for: Most stores

Item Quantity

Require a minimum number of items

Best for: Wholesale, bundles

Cart Weight

Require a minimum cart weight

Best for: Shipping-sensitive

Dynamic Message Variables

Use these variables in your custom messages:

  • {remaining} — The amount still needed (e.g., "$15.00")
  • {minimum} — The total required (e.g., "$50.00")
  • {current} — The current cart value (e.g., "$35.00")

Default messages:
Below minimum: "Add {remaining} more to checkout"
Minimum met: "Minimum met! Ready to checkout"

Using Multiple Rules (Pro)

With Pro, create unlimited rules. The first matching rule (by priority) wins.

RuleMinimumPriorityConditions
Wholesale$20010Customer tag = "wholesale"
Holiday Special$305Scheduled Dec 1-31
Standard$501None (default)

Display Settings

Progress Bar

  • Show progress bar: Toggle the animated bar on/off
  • Show product suggestions (Pro): Recommend products to help reach the minimum
  • Position: Top of cart, bottom of cart, or inline

Checkout Behavior

  • Block checkout: Disable checkout button until minimum is met
  • Show in cart drawer (Pro): Display progress bar in slide-out cart drawers

Progress Bar Features

  • • Updates in real time as customers add or remove items
  • • Shows current value and minimum target (e.g., "$35 / $50")
  • • Changes color when close to the minimum
  • • Turns green with success message when minimum is met
  • • Respects prefers-reduced-motion for accessibility
  • • Includes ARIA attributes for screen readers

Targeting & Conditions (Pro)

Condition Types

Customer Tags

Different minimums for wholesale, VIP, or any tagged group

Collections

Apply minimums to specific collections only

Product Tags

Target products with specific tags

Logic Options

  • ALL conditions match (AND): Customer must meet every condition
  • ANY condition matches (OR): Customer needs to meet just one

Scheduling (Pro)

Set rules to activate and deactivate on specific dates:

  • • Holiday minimum: Active December 1-31
  • • Summer promotion: Lower minimum June-August
  • • Flash sale: 24-hour reduced minimum

Analytics (Pro)

Minimums Shown

Number of times the progress bar was displayed

Checkouts Blocked

Low-value checkout attempts prevented

Added More

Customers who increased their cart after seeing the bar

Recovery Rate

Percentage of blocked customers who added more

The Pro plan also includes device breakdown (Desktop, Mobile, Tablet), conversion funnel visualization, and 14-day trend data.

Tip: A healthy recovery rate is 20-40%. If yours is lower, consider reducing your minimum or adding product suggestions.

Customization (Pro)

Color Customization

Bar Color

Default: #DD6B20 (orange)

Bar Background

Default: #FED7AA (light orange)

Text Color

Default: #1A1A1A (dark)

Success Color

Default: #38A169 (green)

Branding

Free plan shows a small "Powered by LimeForge" text below the progress bar. Pro plan users can toggle this off.

Supported Languages

EnglishSpanishFrenchGermanPortugueseItalianDutchJapanese

Troubleshooting

Progress Bar Not Showing

  1. Check that you have at least one enabled rule
  2. Verify the MinimumCart block is added to the Cart page template
  3. Make sure there are items in your cart
  4. Clear your browser cache and try again

Checkout Button Not Blocking

  1. Verify "Block checkout" is enabled in MinimumCart settings
  2. Some themes have non-standard checkout buttons — contact support
  3. Third-party checkout apps may have compatibility issues

Rules Not Working as Expected

  1. Check rule priority — highest priority number wins
  2. Verify conditions are correct (customer tags, collection handles)
  3. Ensure the rule is enabled
  4. Check scheduling dates if set

Analytics Not Recording

  1. Analytics require the Pro plan
  2. Events may take a few minutes to appear
  3. Ad blockers can prevent analytics events

Frequently Asked Questions

Q: Do I need to edit any code?

A: No. MinimumCart uses Shopify's native theme block system. Just add the block through the theme editor.

Q: Does MinimumCart slow down my store?

A: No. The progress bar CSS and JavaScript are loaded only on the cart page. Total size is under 15KB and analytics are sent asynchronously.

Q: What themes are supported?

A: MinimumCart works with all Shopify themes that support theme app extensions (Online Store 2.0), including Dawn, Refresh, Horizon, Tinker, and most third-party themes.

Q: Can I have different minimums for different customers?

A: Yes, with the Pro plan. Use customer tag conditions to create different rules for wholesale, VIP, or any customer group.

Q: What currencies does MinimumCart support?

A: MinimumCart uses whatever currency your Shopify store uses. The progress bar displays values in your store's currency format.

Q: Does it work with cart drawer apps?

A: MinimumCart detects most native theme cart drawers. Third-party cart drawer apps may vary — contact support with your app name.

Q: Is there a free trial?

A: Yes! Pro plan includes a 7-day free trial with full access to all features.

Q: Can I cancel anytime?

A: Yes, cancel anytime from the Plans page. You keep Pro features until the end of your billing period.

Contact & Support

Email: support@limeforge.app

Response Time:

  • Free plan: 2-3 business days
  • Pro plan: Within 24 hours

When contacting support, please include: Your store URL, description of the issue, screenshots if applicable, browser and device information.

Last updated: February 2025

MinimumCart is developed by LimeForge