The GWP Automator: Professional Gift-With-Purchase Management

The “AOV” Ceiling

Increasing your Average Order Value (AOV) is the fastest way to scale, but manually nudging customers to “add one more thing” is a constant battle. Gift-With-Purchase (GWP) promotions are a proven psychological trigger, yet they are notoriously difficult to manage. Most merchants end up with a mess of discount codes that don’t stack or bloated apps that slow down the site. If you can’t easily toggle rules or track which gifts are active, you’re missing out on your most powerful conversion lever.

The Solution: Sidekick It

Today, we’re using Shopify Sidekick to build the GWP Automator. This is a comprehensive rule management system that gives small merchants enterprise-level promotional power. It provides an intuitive interface to manage multiple tiers (e.g., Free Socks at $50, Free Tee at $150) and includes a built-in Theme Implementation Guide that generates the specific Liquid and AJAX code needed to make the magic happen on your storefront—zero monthly fees required.

PREREQUISITES

Before you begin, ensure your lab is ready:

• Shopify Plan: You must be on the Grow, Advanced, or Plus plan to access Sidekick App Generation.
• Sidekick Access: Ensure the Sidekick icon is visible in your Shopify Admin (Desktop only).
• Theme Access: You’ll need access to your Shopify theme code (Online Store > Themes > Actions > Edit Code).
• A “Gift” Product: A specific product (or variant) you intend to give as a gift, configured correctly (see Caution below).

GWP Automator - Recreation Prompt
Build a custom Shopify admin app called 'Gift-With-Purchase (GWP) Automator' that manages free gift promotional rules.
Main Dashboard:
Display all GWP rules in a sortable table
Show: Rule Name, Threshold, Gift Product, Gift Variant, Status, Actions
Share, Help, and Add New Rule buttons in header
Edit and Delete actions for each rule
Toggle switches for active/inactive status
Create/Edit Rule Form:
Rule name text field
Threshold amount (currency input)
Product search with thumbnail previews
Variant selector (if product has multiple variants)
Active/Inactive toggle
Save and Cancel buttons
Data Storage:
Store rules in shop metafields (namespace: 'sidekick', key: 'gwp_rules')
Each rule: id, name, threshold, giftVariantId, giftProductTitle, giftVariantTitle, giftProductImage, active, createdAt
Theme Implementation Section:
Appears below rules table when rules exist
'Generate Liquid Code' button
Opens modal with:
Complete, production-ready Liquid code snippet
Code that fetches GWP rules from metafields
Automatic cart checking and gift addition/removal logic
AJAX-based cart updates
Gift marking with '_gwp_gift' property
Comprehensive implementation instructions for ALL cart types (regular cart page, slide-out drawer, ajax cart)
How to identify which cart type your theme uses
Best practices for each cart style
Important notes section with troubleshooting tips
Generated Liquid Code Features:
Reads shop.metafields.sidekick.gwp_rules
Parses JSON rules
Checks cart.total_price against thresholds
Finds highest applicable rule
Uses fetch API to add/remove gifts from cart
Handles edge cases (gift already in cart, multiple rules)
Automatically reloads cart after changes
Features:
Search products with GraphQL (250 results max)
Fetch variants for selected products (including correct default variant IDs via GraphQL)
Form validation (threshold greater than 0, product required)
Success/error banners
Empty state when no rules exist
Sort rules by threshold (lowest to highest)
Help Documentation:
What is Gift-With-Purchase
How to create a rule
Selecting gift variants
Best practices
Setting up free gift products (pricing at $0, clear titles, inventory tracking, visibility management)
Limitations
Implementation options (Theme Integration as #1 recommended, Shopify Functions, Third-party apps)
Using the Theme Implementation Guide section
Next steps
Share Button:
Share modal with app overview
Key features list (9 features)
Who should use this app
This exact recreation prompt
Getting started steps
Tips for success
Technical Requirements:
All modals have working close buttons with onClick handlers
CRITICAL: When handling products with only default variants, fetch the actual variant ID via GraphQL query instead of string replacement
Use proper error handling for all GraphQL queries
Implement timestamp-based reload loop prevention in generated Liquid code

Key Features of Your New App

• Unlimited Multi-Tier Rules: Set different gifts for different spend levels; the app automatically finds the highest applicable gift for the customer.
• Smart Logic Handling: The generated code includes “Removal Logic”—if a customer removes items and drops below the threshold, the gift is automatically pulled from the cart.
• Variant-Specific Gifting: Don’t just give away a “Shirt”—specify the exact SKU, size, and color to keep your inventory perfectly synced.
• Persistent Storage: Rules are saved in your Shopify Metafields, meaning the data stays with your store even if you update your theme.Detail the features (e.g., “Audits your catalog,” “Instant Updates”).

The GWP Logic Flow: How the Magic Happens

1. Customer Action: A customer adds an item to their cart or updates a quantity.
2. Theme Interception: Your theme’s AJAX cart update (often a JavaScript event) is triggered. The sidekick-gwp.liquid snippet, included in your theme, listens for this event.
3. Rule Retrieval: The snippet reads your active GWP rules directly from the Shop Metafields (sidekick.gwp_rules).
4. Cart Evaluation: The script calculates the current cart.total_price.
5. Decision Point: It compares the cart.total_price against the thresholds of your active GWP rules.
   • If Threshold Met: The script checks if the highest applicable gift is already in the cart. If not, it uses the Shopify Fetch API (/cart/add.js) to add the free SKU.
   • If Threshold NOT Met: The script scans the cart for any items previously added by the GWP Automator (_gwp_gift property). If found, it uses the Fetch API (/cart/change.js) to remove them.
6. UI Refresh: After the gift is added or removed, the script triggers a cart refresh, instantly updating the cart drawer or page to reflect the change.

Technical Note: Theme Integration

While Sidekick builds the manager, you must place the generated code into your theme to see it on the storefront. Use the “Generate Liquid Code” button inside your new app. If you use a Slide-out Drawer (like in the Dawn or Impulse themes), ensure you place the {% render 'sidekick-gwp' %} tag in your cart drawer snippet, not just the main cart page.

Test in Preview: Add items to your cart in the duplicate theme preview to ensure the AJAX “Add to Cart” triggers correctly and the gift appears/disappears as expected, without refreshing the page. This prompt uses the [Mutation Name] to update live store data.”

Caution: Modify with Care

Before adding the generated code to your theme, always:

Duplicate your theme: Go to Online Store > Themes > Actions > Duplicate. Never edit your live theme directly.

Create a $0 Product: Set your gift product’s price to $0.00 and ensure “Track quantity” is enabled in its inventory settings.

The Sidekick Challenge: Check your current Average Order Value (AOV). Set your first GWP rule threshold at 15% higher than that average. Post in the comments if this nudge helped increase your weekly revenue!