Skip to content

Quick Start Guide

Get MUP compliance working in your store in 5 minutes!

Step 1: Setup Metafields (1 minute)

  1. Go to MUP Settings in the app

  2. Click "Setup Metafields" button

  3. Wait for confirmation message

This creates all required metafield definitions in Shopify.

Step 2: Create Levy Product (1 minute)

  1. In MUP Settings, click "Create Levy Product"

  2. The app will automatically:

  3. Create a "MUP Levy" product
  4. Set it up as a fee/product type
  5. Save the variant ID to settings

Step 3: Configure Settings (1 minute)

  1. In MUP Settings, verify:
  2. Minimum unit price: 0.65 (default for Scotland)
  3. Levy product variant ID: Should be auto-filled from Step 2

  4. Enable MUP Enforcement: ✅ Checked

  5. Click "Save Settings"

Step 4: Add Validation Function to Checkout Rules (1 minute)

  1. Go to Shopify Admin → Settings → Checkout

  2. Scroll to Checkout rules section

  3. Click "Add a checkout rule"

  4. Select "Cart validation" as the rule type

  5. Find and select "MUP Validation" function

  6. Click "Save"

This ensures checkout is blocked for MUP violations.

Step 5: Add Alcohol Units to a Test Product (1 minute)

  1. Go to Products in Shopify Admin

  2. Select a product with alcohol

  3. Go to Metafields section

  4. Add custom.total_units metafield with value (e.g., 2.5 for a 500ml can at 5% ABV)

  5. Save the product

Test It!

  1. Add the test product to cart

  2. Set region to "Scotland" using the region selector

  3. Check cart - you should see:

  4. Original product at its price
  5. MUP Levy line item (if price < MUP floor)

The cart transform runs automatically - no manual activation needed!

What's Next?

Troubleshooting

Cart transform not working? - Verify region is set to "Scotland" - Check browser console for errors - Ensure MUP enforcement is enabled in settings

Levy not appearing? - Verify product has total_units metafield - Check that product price per unit < £0.65 - Ensure MUP enforcement is enabled

For more help, see Troubleshooting.