How to Create a Discount on Shopify with Shopify Functions

Introduction
Clarifying the Goal and Constraints
Confirming Platform Capabilities and Limits
Step-by-Step: Creating a Native Discount
Choosing the Right Approach: Beyond Native Tools
The Technical Deep Dive: Creating Discounts via Shopify Functions
Safety and Implementation: The Nextools Workflow
Advanced Scenario: Preventing Discount Fraud
Choosing Your Nextools Solution
Nextools Shopify App Suite (Quick Links)
Conclusion
FAQ

Introduction

Modern e-commerce complexity often outpaces basic platform features. For Shopify Plus merchants and high-growth agencies, the challenge isn’t just knowing how to create a discount on Shopify; it is ensuring that discount logic remains performant, scales across global Markets, and doesn’t conflict with complex shipping or payment rules. With the deprecation of Shopify Scripts and the transition to Checkout Extensibility, developers and merchants are under increasing pressure to migrate legacy logic to Shopify Functions. Failure to do so risks broken checkouts and lost revenue.

At Nextools, we specialize in bridging this technical gap. Our Shopify App Suite is built specifically to provide the advanced checkout logic required by enterprise-level stores without the heavy overhead of maintaining custom private apps. Whether you are an agency developer looking for a faster way to deploy complex BOGOs or a merchant trying to implement tiered volume discounts across multiple currencies, understanding the architecture of modern Shopify discounts is critical.

This guide follows the Nextools Playbook for engineering-minded workflows: we will clarify your goals and constraints, confirm platform limits, choose a durable Functions-first approach, and outline a safe implementation and measurement strategy.

Clarifying the Goal and Constraints

Before clicking “Create discount” in your admin, you must define the logic’s boundaries. A discount in a vacuum is easy; a discount that interacts with tiered shipping rates, specific payment methods, and international market restrictions is a technical challenge.

Understanding Your Shopify Plan

The method you choose for creating discounts depends heavily on your Shopify plan.

Basic, Shopify, and Advanced: These plans are limited to native discount types (Percentage, Fixed amount, Buy X Get Y, Free Shipping) and third-party apps that utilize the standard Discount APIs.
Shopify Plus: Plus merchants have access to Shopify Functions and Checkout Extensibility. This allows for bespoke logic—such as discounting based on customer metafields, cart attributes, or complex “if-this-then-that” scenarios—that was previously handled by Ruby-based Shopify Scripts.

The Impact of Shopify Markets

If you operate in multiple regions, a simple discount can become a logistical nightmare. You must decide if the discount should apply globally or be restricted to specific Markets. Shopify’s native tools now allow for market-based eligibility, but if you need to dynamically adjust discount value based on the local currency’s rounding rules, you will likely need a more robust solution like those found in our Shopify App Suite.

Discount Stacking and Combinations

One of the most frequent support tickets we see involves “discount conflicts.” Shopify categorizes discounts into three classes:

Product discounts
Order discounts
Shipping discounts

By default, discounts within the same class often do not stack unless explicitly configured. When you create a discount, you must determine if it should be eligible to combine with other active promotions. Overlooking this can lead to “stacking abuse” where a customer applies a product discount, an order-level code, and a free shipping offer, potentially wiping out your margin.

Confirming Platform Capabilities and Limits

To build a reliable promotion strategy, you must work within the technical guardrails of the Shopify platform.

Native Limits to Keep in Mind

Code Volume: Shopify supports up to 20 million unique discount codes per store. While this sounds vast, high-volume merchants using unique codes for every influencer or email lead can hit this limit over several years.
Item Entitlements: A single discount code can apply to a maximum of 100 specific customers, products, or variants. If your promotion targets 150 specific SKUs, you cannot list them individually; you must use a Collection instead.
Performance and Latency: Legacy apps often relied on “draft order” hacks or theme-side scripts to apply discounts. These are brittle and slow down the checkout. Shopify Functions, however, run on Shopify’s infrastructure with near-zero latency, ensuring that even the most complex logic doesn’t hurt your conversion rate.

The Role of Shopify Functions

Shopify Functions have replaced Scripts as the gold standard for customization. They allow developers to write custom logic that Shopify executes server-side. At Nextools, we emphasize a “Functions-first” approach because it is:

Future-proof: Built on WebAssembly (Wasm), these are the foundation of Shopify’s long-term architecture.
Compatible: They work seamlessly with Shopify Markets and Checkout Extensibility.
Secure: Logic is executed by Shopify, not a third-party server, reducing the risk of downtime or data leaks.

Step-by-Step: Creating a Native Discount

For many standard use cases, Shopify’s native UI is the starting point. Here is the technical workflow for setting up a basic discount.

1. Choose Your Method: Code vs. Automatic

Discount Codes: Require manual entry by the customer. These are best for exclusive offers, “win-back” email campaigns, and influencer tracking.
Automatic Discounts: Applied as soon as the cart meets the criteria. Only one automatic discount can be active at a time (unless using Functions or specific stacking rules). These are superior for conversion but offer less control over who receives the benefit.

2. Select the Discount Type

In your Shopify Admin, navigate to Discounts > Create discount. You will typically see four primary types:

Amount off products: Applies to specific SKUs or collections.
Amount off order: Applies to the subtotal.
Buy X Get Y (BXGY): Ideal for clearing inventory. Note that Shopify’s native BXGY requires the customer to manually add the “Get” item to their cart unless you use an automation tool like AutoCart.
Free shipping: Can be restricted by country or shipping rate price.

3. Define the Logic and Values

Value: Choose between a percentage or a fixed currency amount.
Minimum requirements: Set a minimum purchase amount (e.g., $50+) or a minimum quantity of items (e.g., 3+ items).
Usage limits: Crucial for “first-time buyer” codes. You can limit the discount to “one use per customer” based on email or phone number.

4. Active Dates and Combinations

Set your start date and time based on your store’s primary time zone. In the Combinations section, check the boxes for Product, Order, or Shipping discounts if you want this specific offer to stack with others.

Choosing the Right Approach: Beyond Native Tools

While native discounts work for simple sales, enterprise merchants often require logic that Shopify’s standard UI cannot handle. This is where the Nextools Shopify App Suite comes into play.

When to Use SupaEasy for Discounts

If you need to migrate from Shopify Scripts or create a discount that isn’t available in the admin (e.g., a discount based on a specific customer tag AND a cart attribute), SupaEasy is the tool of choice. It acts as a Shopify Functions generator.

The Problem: Writing Functions requires specialized knowledge of Rust or JavaScript and local development environments.
The Solution: SupaEasy provides a “Wizard” and an AI Functions Generator. You can define your logic in plain language, and the app generates and deploys the Function to your store. This is the simplest way to handle Script-to-Functions migration without hiring a full-time DevOps engineer.

When to Use Multiscount for Tiered Pricing

Native Shopify discounts struggle with “Volume Tiers” (e.g., Buy 5 get 10% off, Buy 10 get 20% off). While you could create multiple native discounts, managing them is tedious. Multiscount is designed for stackable and tiered discounts, providing a storefront widget that updates in real-time as customers add items to their cart.

When to Use AutoCart for “Gift with Purchase”

A common merchant goal is to automatically add a free gift to the cart when a discount is applied. Native Shopify discounts do not support “auto-add.” AutoCart solves this by watching for specific triggers (like a discount code being applied or a cart total being reached) and automatically adding or removing companion products.

The Technical Deep Dive: Creating Discounts via Shopify Functions

For developers, knowing how to create a discount on Shopify means understanding the Discount Function API. This API allows you to target three specific areas of the checkout:

1. Cart Line Discounts (Product Level)

These Functions target specific line items. They are ideal for:

BOGO logic that only applies to certain variants.
Bundle discounts that trigger when a specific combination of products is present.
Member-only pricing based on customer metafields.

2. Order Subtotal Discounts

These Functions look at the entire order. They are useful for:

“Spend $X, Get $Y Off” logic that needs to be calculated after other discounts are applied.
VIP discounts that apply to the whole cart for specific customer segments.

3. Shipping Discounts

Shipping Functions can rename, hide, or discount shipping rates. If you want to offer “Free Express Shipping for Gold Members,” a shipping Function is the most reliable way to implement this without interfering with your standard shipping zones. You can manage these rules easily with HideShip.

The Function Execution Flow

When a buyer interacts with the cart or checkout, Shopify executes your Function. The Function receives a “Run Input” (the current state of the cart) and must return a “Run Result” (the list of discount operations to apply).

Technical Tip: Always ensure your Function is optimized. Shopify imposes a 20ms execution limit on Functions. If your logic involves heavy calculations or external lookups (which are generally not permitted in the Function itself), it will fail silently or fallback to native logic.

Safety and Implementation: The Nextools Workflow

Deploying a new discount logic to a store doing millions in revenue requires a cautious approach. We recommend the following five-step workflow:

1. Development and Sandbox Testing

Never deploy a new Shopify Function or a complex discount app directly to your live production store.

Use a Development Store or a Shopify Plus Sandbox store.
Test all Nextools apps using the Free Dev Store plans. Apps like Cart Block and HidePay offer free unlimited testing in these environments.

2. Edge Case Mapping

Before going live, run through these scenarios:

The “Zero-Dollar” Cart: Does your discount make the cart total $0? If so, does your payment gateway (e.g., Stripe, Shopify Payments) allow a $0 transaction? You might need to hide certain payment methods using HidePay when the total is zero.
Refunds and Returns: How does your discount handle partial returns? If a customer uses a “Buy 3, Get 1 Free” offer and returns one item, Shopify’s native logic will prorate the discount. Ensure this aligns with your store’s return policy.
Conflict with Scripts: if you are in the middle of a migration, ensure your new Shopify Functions aren’t fighting with legacy Shopify Scripts.

3. Staging and QA

Once the logic is verified in a sandbox, move it to a staging environment (often a duplicate theme or a secondary store).

Check the UI: If you are using SupaElements, ensure the checkout banners correctly communicate the discount to the customer.
Verify on Mobile: Over 70% of Shopify traffic is mobile. Ensure that “Apply Discount” buttons aren’t hidden by keyboards or sticky footers.

4. Controlled Rollout

For major sales (like Black Friday), don’t turn on a new discount at midnight. Enable it during a lower-traffic period to monitor for any unexpected behavior.

Check your server logs in the Shopify Admin under Settings > Apps and sales channels > [App Name] > Shopify Functions. Look for any “Execution Failures.”

5. Measuring Impact and Iterating

A discount is only successful if it achieves its goal. Use Shopify Analytics to track:

Conversion Rate: Did the discount actually move the needle?
AOV (Average Order Value): Tiered discounts should ideally increase AOV. If AOV drops too far, your tiers might be too generous.
Customer Lifetime Value (CLV): Are discount-seekers returning to buy at full price, or are they one-time shoppers?

Advanced Scenario: Preventing Discount Fraud

Creating a discount is only half the battle; the other half is ensuring it isn’t abused. High-demand drops often attract bots that stack codes or exploit loopholes in “one use per customer” logic.

At Nextools, we recommend using Cart Block to add a layer of validation to your checkout.

Block specific payment methods when a high-value discount code is used (to reduce chargeback risk).
Validate shipping addresses to ensure a single customer isn’t creating 50 accounts to reuse a “first-order” code.
Set custom validation rules: For example, “This discount cannot be used if the cart contains a ‘limited edition’ product.”

By combining SupaEasy for the discount logic and Cart Block for the guardrails, you create a robust, secure promotional system.

Choosing Your Nextools Solution

If you are still deciding how to create a discount on Shopify that fits your specific needs, use this checklist:

Do you need a standard sale? Use Shopify Native Discounts.
Do you need complex logic or Script migration? Use SupaEasy.
Do you need tiered volume pricing? Use Multiscount.
Do you need to add a free gift automatically? Use AutoCart.
Do you need to hide shipping/payments when a discount is active? Use HideShip and HidePay.

Our Shopify App Suite is designed to work together, allowing you to build a sophisticated checkout experience without the technical debt of a custom-coded solution.

Nextools Shopify App Suite (Quick Links)

Conclusion

Mastering how to create a discount on Shopify requires more than just filling out a form in the admin. For the modern Plus merchant, it means adopting a Functions-first mindset that prioritizes performance, scalability, and security. By following the Nextools Playbook—clarifying constraints, understanding platform limits, choosing durable tools, and implementing safely—you can build a promotional strategy that survives the BFCM rush and drives genuine growth.

Actionable Checklist for Your Store:

Audit existing logic: Identify all active Scripts and draft order hacks.
Check for conflicts: Ensure your Product and Order discount classes are configured to stack only where intended.
Test for performance: If your checkout feels slow, investigate whether legacy apps are causing latency.
Migrate to Functions: Use SupaEasy to convert legacy Scripts into modern Shopify Functions.
Enhance the UI: Use SupaElements to clearly communicate discount value to your customers.

To explore how our full suite can streamline your checkout logic, visit the Nextools Shopify App Suite hub.

FAQ

Do I need Shopify Plus to create custom discount logic?

While standard Shopify plans allow for native discount types and many third-party apps, true custom logic—such as that built with Shopify Functions or legacy Scripts—is primarily a Shopify Plus feature. However, many Nextools apps, like Multiscount and HidePay, offer advanced functionality that works across all Shopify plans by utilizing standard API endpoints where possible.

How do I prevent multiple discount codes from being used at once?

In the Shopify Admin, when you create a discount, look for the “Combinations” section. If you do not select any categories (Product, Order, or Shipping), the discount will be “unstackable.” If a customer tries to add a second code, Shopify will automatically apply only the one that offers the best value. For more complex “mutual exclusivity” rules, you can use SupaEasy to write a Function that specifically prevents certain combinations.

How can I test my discounts without affecting live customers?

The safest way to test is by using a Shopify Development Store or a Plus Sandbox. All Nextools apps are free to use in development environments. You can also create a “private” discount code that is not publicized and test it on your live store by placing a test order while logged in as a staff member, but a sandbox is always preferred for complex Functions logic.

My Shopify Scripts are being deprecated; where do I start?

Shopify is moving all Script logic to Shopify Functions. You should begin by auditing your current Ruby scripts and mapping them to the Discount, Delivery, and Payment Function APIs. SupaEasy is specifically designed to help with this migration, offering an AI-assisted generator that can help recreate Script logic within the new Functions framework without requiring extensive coding knowledge.

Table of Contents