Zuper Free Shipping App - Documentation

Overview

Zuper Free Shipping helps merchants increase order value and improve conversions by automatically unlocking free shipping when shoppers meet a defined threshold.

Merchants can create flexible rules based on: 

  • Minimum cart value
  • Total item quantity
  • Selected products

Once configured, the app evaluates each cart in real time and applies free shipping instantly when conditions are met. A dynamic progress bar on the storefront motivates customers to add more items, while all settings are securely stored in Shopify metafields for a smooth and native experience. 

The app leverages Shopify Discount Functions to ensure that free shipping is applied automatically at checkout and removed if conditions are no longer met, providing a consistent and seamless experience across storefront and backend.

Key Features

Automatic Free Shipping

Free shipping is applied instantly when customers meet the defined threshold, creating a seamless checkout experience.

Custom Threshold Setup

Merchants can define rules based on cart value, total item quantity, or specific products, allowing flexible and targeted incentives.

Dynamic Progress Bar

Displays a live progress bar on the storefront to motivate customers to reach the free shipping goal, encouraging higher spending.

Real-Time Cart Evaluation

As customers add or remove items, the app updates shipping eligibility and the progress bar instantly, ensuring accurate and up-to-date information.

Merchant Experience

Install the App

Install Zuper Free Shipping directly from the Shopify App Store.

Configure Free Shipping Rules

Open the Admin Dashboard and set your desired free shipping threshold based on cart value, item quantity, or selected products.

Save Settings Securely

Once saved, the app securely stores your configuration in Shopify shop metafields.

Enable the Theme App Extension

Activate the Theme App Extension to display the dynamic free shipping progress bar on your storefront.

Test the Experience

Add products to the cart and watch the progress bar update. When the threshold is reached, free shipping is automatically applied at checkout.

Permissions Requested

Zuper Free Shipping requests only the minimum permissions required to operate correctly:

  • read_products – Allows the app to identify products when merchants create product-based free shipping rules.
  • write_shop_metafields – Used to securely store free shipping configuration data such as threshold values and condition types.
  • read_discounts / write_discounts – Enables the app to create, apply, and manage automatic free shipping discounts at checkout.

These permissions are strictly used to provide the app’s core functionality and are never accessed for unrelated purposes.

Data Handling & Privacy

Zuper Free Shipping is designed with privacy and security in mind.

  • No personal customer data is stored or transmitted by the app.
  • Only shop-level configuration data (such as threshold values and condition types) is saved.
  • All settings are stored securely using Shopify metafields.
  • All communication is encrypted using OAuth 2.0 to ensure data protection and compliance with Shopify standards.

Testing Instructions for Shopify Review Team

  1. Install the app on a test store.
  2. Open the dashboard and set a threshold. Example: ₹500 minimum cart value.
  3. Enable the Theme App Extension.
  4. Add products to the cart and observe the dynamic progress bar.
  5. Exceed the threshold to trigger the free shipping discount.
  6. Remove items to go below the threshold and confirm the discount is removed.

Expected Behavior

  • Free shipping is applied only when the condition is met.
  • The progress bar updates instantly as the cart changes.
  • The discount is removed automatically when conditions are no longer satisfied.

App Function Summary

  • App Function Summary Admin Dashboard – Allows merchants to configure free shipping thresholds and saves the settings securely in Shopify metafields.
  • Shopify Discount Function – Reads metafield values and dynamically applies free shipping at checkout when conditions are met.
  • Theme App Extension – Displays the progress bar and motivational messaging on the storefront to encourage higher cart values.
  • Processing Logic – Keeps storefront behavior and backend discount logic synchronized to ensure accurate and consistent free shipping application.

Screenshot : The Free Shipping progress bar appears on the cart page of the website.

Zuper Free Shipping App - Documentation
Zuper Free Shipping App - Documentation


Screenshot: Flexible Shipping Options:

Create rules using cart value, quantity, or products, and customize the shipping bar to match your store.

Zuper Free Shipping App - Documentation

Screenshot: Market-Based Shipping Eligibility

Control minimum shipping eligibility using market-based pricing and track each product’s conversion value.

Zuper Free Shipping App - Documentation

Screenshot: Track Product Conversion Values

To address merchant needs, we’ve added built-in conversion rate support, allowing merchants to display multiple currencies to customers. Merchants can also customize the currency symbol for better localization. (Note: Currency display does not affect the checkout page.)

Track how each product contributes to free-shipping conversions and identify which items encourage customers to engage with the shipping bar. The app automatically detects the store’s currency from Shopify Markets and updates pricing accordingly. Currency changes apply only when Shopify Payments is enabled.

Zuper Free Shipping App - Documentation

Conclusion

Zuper Free Shipping empowers merchants to increase sales and boost customer engagement by offering automatic, condition-based free shipping. Beyond just free shipping, the app allows merchants to:

  • Customize the Shipping Bar – Tailor the appearance and messaging to match your store’s branding.
  • Set Minimum Shipping Values by Marketplace – Configure thresholds based on different markets or currencies.
  • Track Product Conversion Values – Understand how individual products contribute to free shipping goals and optimize your catalog accordingly.

Built entirely with Shopify-native technologies, Zuper Free Shipping ensures a seamless, secure, and real-time experience for both merchants and customers. With flexible rules, dynamic progress bars, and advanced tracking, the app helps merchants maximize average order value, improve conversions, and deliver a motivating shopping experience.

Support

Need help setting up or customizing your Free Shipping Bar?
We’re here to help!

Tips & Best Practices

  • Keep your free shipping threshold slightly above your average order value to maximize upsells.
  • Use motivating messages like “Almost there!” or “Just a few more items to go!”
  • Test visibility across devices to ensure the bar looks great on mobile and desktop.