Promotions

Add free gift over order threshold

Adds a configured free-gift variant to paid orders above a threshold using Shopify order edits.

When to use this template

This template is built for Shopify stores using the JsWorkflows app.

Use this template when you want a ready-made workflow for this use case: Adds a configured free-gift variant to paid orders above a threshold using Shopify order edits.

It is designed for Shopify promotion workflows and gives you a production-ready starting point instead of building the automation from scratch.

This workflow uses the Shopify webhook trigger model and starts from the "Order paid" trigger. It includes setup fields for merchant-facing values, so you can configure the workflow before installing it.

Setup guide

Before you start

This template watches paid orders and uses Shopify order edits to add a configured free gift when the order total exceeds your threshold.

Configure in setup

  • Order total threshold: minimum paid order total required before the free gift is added
  • Free gift variant ID: Shopify product variant GID for the free gift item
  • Gift quantity: how many free units to add
  • Notify customer on edit: whether Shopify should email the customer about the order edit

Notes

  • The template skips orders that already contain the configured gift variant
  • Shopify must allow order edits for the order when the workflow runs
  • The free gift is discounted to 100% using the order edit API

Setup fields

Order total threshold
numberRequiredconfig

Minimum paid order total in shop currency required before the gift is added.

Free gift variant ID
textRequiredconfig

Shopify product variant GID to add as the free gift.

Gift quantity
numberRequiredconfig

How many units of the free gift variant to add.

Notify customer on edit
checkboxRequiredconfig

If enabled, Shopify sends the customer an order update email after the order edit is committed.