JSON Based Discount Builder Document

JSON-Based Discount Builder — Documentation


Build flexible Shopify discounts with powerful JSON-based rules and conditions.

JSON-Based Discount Builder gives Shopify merchants a flexible way to create and manage advanced discount logic for products, orders, and shipping. Build customized discount rules using JSON, conditions, variables, and discount actions — all from one centralized app.

Whether you need product-specific discounts, order-level offers, shipping discounts, quantity-based rules, or more advanced conditions, the app helps you create and manage your discount logic in a structured and flexible way.


Build Smarter Shopify Discounts

JSON-Based Discount Builder gives Shopify merchants the flexibility to create structured discount logic using JSON, conditions, variables, and Shopify Functions.

From simple product discounts to advanced multi-condition scenarios, you can build, manage, and maintain your discount logic from one centralized place.

Create flexible discount rules that match the way your store actually sells.


✨ Why Choose JSON-Based Discount Builder?

Shopify stores often need discount rules that go beyond simple percentage or fixed-amount offers. JSON-Based Discount Builder provides a flexible rule-based approach that allows merchants to define exactly when and how their discounts should apply.

Key Features

⚙️ JSON Rule Engine
Create structured discount rules using JSON. Define variables, conditions, and discount actions to build customized discount logic.

🛍️ Product Discounts
Create discounts based on products, variants, quantities, collections, tags, and other supported product conditions.

🛒 Order Discounts
Build cart and order-level discount rules based on the conditions that matter to your store.

🚚 Shipping Discounts
Configure shipping discount logic based on supported cart, product, customer, and order conditions.

🔀 Advanced Conditions
Combine multiple conditions and comparisons to create more precise discount scenarios.

🧩 Function Management
Manage your discount functions and configurations from a centralized interface, making it easier to organize and maintain your discount logic.


⚙️ Build Discounts With a JSON Rule Engine

The JSON Rule Engine is the core of JSON-Based Discount Builder.

Instead of creating a separate configuration for every discount scenario, you can define your discount logic using a structured JSON format.

Your rules can include:

  • Variables
  • Conditions
  • Comparisons
  • Product data
  • Cart data
  • Customer-related conditions
  • Quantity conditions
  • Metafield values
  • Discount actions
  • Multiple rule conditions
  • Product, order, and shipping discount operations

This provides greater flexibility when building discount scenarios for different store requirements.


🛍️ Create Flexible Product Discounts

Use Product Discounts to create discount rules that apply to eligible products or cart lines.

You can build rules around supported conditions such as:

  • Products
  • Product variants
  • Collections
  • Product tags
  • Quantities
  • Product properties
  • Metafields
  • Cart line information
  • Customer conditions

For example, you can create rules that apply different discounts depending on the products in the cart or the quantity purchased.

This makes it possible to create simple product discounts as well as more advanced product-based discount scenarios.


🛒 Configure Order Discounts

The Order Discounts feature allows you to create discount logic based on the overall cart or order.

Create rules based on supported conditions such as:

  • Cart value
  • Cart quantity
  • Products in the cart
  • Customer information
  • Product properties
  • Multiple conditions
  • Custom variables

You can combine different conditions to determine when an order-level discount should be applied.

This is useful for creating customized offers such as threshold-based discounts, customer-specific offers, or other cart-level discount scenarios.


🚚 Create Shipping Discounts

With Shipping Discounts, you can create rules that determine when shipping discounts should apply.

Configure supported conditions based on information such as:

  • Cart contents
  • Products
  • Quantities
  • Customer information
  • Order conditions
  • Shipping-related data

Build shipping rules that match your store's specific requirements and apply the appropriate discount when the configured conditions are met.


🔀 Create Advanced Discount Conditions

Not every discount can be handled with a single condition.

Advanced Conditions allows you to combine multiple conditions to create more specific discount rules.

You can build logic using supported:

  • Comparisons
  • Variables
  • Product conditions
  • Cart conditions
  • Quantity conditions
  • Customer conditions
  • Metafield values
  • Multiple conditions
  • Logical relationships

For example, a discount can be configured to apply only when multiple requirements are satisfied.

This gives merchants greater control over when a discount should and should not apply.


📦 Use Variables in Your Discount Rules

Variables allow you to work with dynamic values inside your JSON rules.

Depending on the available data exposed to the discount function, variables can represent information such as:

  • Product values
  • Cart values
  • Quantities
  • Customer data
  • Metafield values
  • Discount configuration values

Variables can then be used within conditions and discount calculations to create more dynamic rules.


🏷️ Work With Product Metafields

JSON-Based Discount Builder can use supported product metafields exposed to the discount function as part of discount logic.

This allows your discount rules to use custom product information when determining whether a discount should apply.

For example, a store can use a custom product metafield as an input for a discount condition or calculation when that metafield has been made available to the function.

The exact metafields available depend on the fields configured and exposed to the discount function.


🧩 Manage Your Discount Functions

The Function Management section provides a centralized place to manage your discount functions and their configurations.

From here, you can manage the functions used by your discount rules and keep your discount logic organized.

This is particularly useful for stores that have multiple discount scenarios and need a structured way to manage their configurations.


🔄 How JSON-Based Discount Builder Works

Creating a discount with the app follows a simple rule-based workflow:

1. Choose Your Discount Type

Select the type of discount you want to create:

  • Product Discount
  • Order Discount
  • Shipping Discount

2. Define Your Rules

Create your JSON structure and define the logic required for your discount.

3. Add Conditions

Configure the conditions that determine when your discount should apply.

4. Configure Variables

Add the variables required for calculations, comparisons, or dynamic discount logic.

5. Define the Discount Action

Specify the discount operation and the value that should be applied when the configured conditions are satisfied.

6. Save and Activate

Save your configuration and activate the corresponding discount function.

7. Test Your Discount

Add the required products or create the required cart scenario on your storefront and verify that the discount behaves as expected.


💡 Example Discount Scenarios

JSON-Based Discount Builder can be used to create different types of discount logic, depending on the conditions and operations supported by your configuration.

Examples include:

Quantity-Based Discounts

Offer different discounts depending on the quantity of eligible products in the cart.

Product-Specific Discounts

Apply a discount only when selected products or variants are present.

Collection-Based Discounts

Create rules that apply discounts to eligible products belonging to specific collections.

Cart Value Discounts

Apply an order discount when the cart reaches a configured value.

Customer-Based Discounts

Create discount logic based on supported customer information.

Metafield-Based Discounts

Use supported product metafields as inputs for discount conditions or calculations.

Combined Conditions

Require multiple conditions to be satisfied before applying a discount.


🎯 Build More Flexible Discount Strategies

The combination of JSON rules, variables, and advanced conditions allows merchants to create discount strategies for different business requirements.

For example, you can configure logic where:

  • Different quantities receive different discounts
  • Specific products receive different discount values
  • Discounts depend on multiple cart conditions
  • Product information determines discount eligibility
  • Custom metafield values influence discount calculations
  • Order-level discounts are applied only when specific requirements are met
  • Shipping discounts are triggered by configured conditions

Your discount logic can be structured around the requirements of your store rather than being limited to a single simple discount condition.


🚀 Quick & Simple Setup

Getting started with JSON-Based Discount Builder takes only a few steps:

  1. Install JSON-Based Discount Builder from the Shopify App Store.
  2. Choose the discount type you want to create.
  3. Configure your JSON rule using the available structure.
  4. Add conditions and variables required for your discount logic.
  5. Configure the discount action and required values.
  6. Save and activate your discount function.
  7. Test the discount on your storefront.

Once your function is configured and active, Shopify can evaluate the discount logic during the applicable purchase flow.


🛡️ Structured & Maintainable Discount Logic

Managing complex discounts can become difficult when multiple rules and conditions are involved.

JSON-Based Discount Builder keeps your discount logic structured so you can clearly define:

  • What conditions should be checked
  • Which values should be compared
  • Which variables should be used
  • When the discount should apply
  • What discount action should be performed

This makes it easier to understand and maintain your discount configurations as your store's requirements evolve.


🛟 Need Help?

If you need help configuring your JSON rules, conditions, variables, or discount functions, our support team can assist you with the setup and troubleshooting.

For faster assistance, include your Shopify store URL, the discount scenario you are trying to create, your JSON configuration, and screenshots or a screen recording when possible.

 


What discount types can I create?

You can build Product, Order, and Shipping discounts using flexible JSON configurations. The rule engine supports a wide range of promotional scenarios, from simple percentage discounts to advanced conditional logic.

Do I need programming experience to use the app?

No. The app includes documentation, sample JSON configurations, and a structured editor to help you create discount rules, whether you're just getting started or building advanced logic.

Can I create conditional discount rules?

Yes. Use variables, comparisons, logical operators, loops, and built-in functions to create highly customized discount conditions based on your business requirements.

Can I test my JSON configuration before activating it?

Yes. The built-in testing tool lets you validate your JSON configuration before saving and activating your discount function.

Can I update an existing discount function?

Absolutely. Open any saved function, modify the JSON configuration, and save your changes to update the discount logic whenever needed.

Does the app support multiple discount functions?

Yes. You can create and manage multiple discount functions, each with its own JSON configuration and business rules.

Are reusable JSON templates supported?

Yes. You can reuse existing JSON configurations to quickly create similar discount functions, helping maintain consistency across promotional campaigns.

Can I combine different discount conditions?

Yes. The JSON rule engine allows you to combine multiple conditions, variables, and expressions to create sophisticated discount workflows tailored to your store.