Skip to content

MUP Compliance App Documentation

Welcome to the Minimum Unit Pricing (MUP) Compliance App documentation. This app ensures your Shopify store complies with Scotland's Minimum Unit Pricing law for alcohol sales.

What is MUP?

Minimum Unit Pricing (MUP) is a Scottish law that requires alcohol to be sold at a minimum price of £0.65 per alcohol unit. This app automatically enforces this requirement for all orders destined for Scotland.

Key Features

  • ✅ Automatic Levy Calculation: Automatically calculates and adds levy charges when products are priced below the MUP floor
  • ✅ Checkout Validation: Blocks checkout if discounts would violate MUP requirements
  • ✅ Region Detection: Automatically detects Scottish customers at checkout via postcode and also via region selector
  • ✅ Product Health Check: Scans your catalog to identify products missing alcohol unit data
  • ✅ Checkout Guidance: Provides clear UI guidance to customers about MUP requirements

How It Works

  1. Customer adds product to cart → Cart transform function checks if MUP levy is needed
  2. If price < MUP floor → Levy is automatically added as a child line item
  3. Customer applies discount → Validation function checks if discounted price violates MUP
  4. If violation detected → Checkout is blocked with clear error message
  5. Customer completes order → Order is processed with MUP compliance

Important: The validation function must be added to checkout rules in Shopify Admin → Settings → Checkout.

App Components

Extensions

  • Cart Transform (mup-cart-transform) - Automatically adds levy charges to cart
  • Validation Function (mup-validation) - Blocks checkout for MUP violations
  • Checkout UI (mup-checkout) - Provides customer guidance at checkout
  • Region Selector (uk-region-selector) - Allows customers to select their UK region

Admin Features

  • MUP Settings - Configure levy product, minimum price, and enforcement
  • Health Check - Scan products for missing alcohol unit data
  • Manual Actions - Manually activate cart transform, update metafields, etc.

Support

For issues or questions: 1. Check the Troubleshooting Guide 2. Review the API Reference 3. Check app logs in your Gadget dashboard

Ready to get started? Head to the Installation Guide!