Unlock Seamless Discount Workflows with Shopify’s New App Intent Support

Shopify now lets discount apps built with Functions register app intents, enabling custom create and edit flows directly from the admin UI. Learn what changed, who’s affected, and how to implement the new intents today.

Unlock Seamless Discount Workflows with Shopify’s New App Intent Support
6 sections

Shopify’s latest developer update introduces shopify/Discount app intents, a powerful way for discount apps that use Shopify Functions to surface their own create and edit experiences directly within the admin. This change means merchants can launch a custom discount flow without ever leaving the Shopify UI, and developers gain tighter integration with Sidekick and the disambiguation picker. Below we break down what’s new, who needs to pay attention, and the exact steps to take advantage of this capability.

What Changed: New Discount App Intents

The shopify/Discount intent now supports both create and edit actions for discount apps built with Shopify Functions. Apps register an intent via the shopify-intent.json meta‑schema, referencing the shopify/discount.json baseline schema. A matchValue on functionId ties each intent to a specific Function implementation, allowing a single app to expose multiple discount types. When a merchant clicks a discount link, Shopify either launches the app’s custom UI (via admin.app.intent.link or admin.app.intent.render) or falls back to a disambiguation picker if multiple intents match.

Who Is Affected: Developers vs. Merchants

The update targets apps that create new discount types using Shopify Functions. Existing discount apps that rely on Shopify’s default UI continue to work unchanged—no migration is required. For merchants, the change is transparent unless they install a Function‑backed discount app; in that case they’ll notice a smoother flow when creating or editing those discounts, staying within the app’s dedicated UI instead of the generic discount screen.

Why It Matters: Better Discount Creation & Editing

Merchants gain a consistent experience: whether they’re creating a new “Buy X Get Y” discount or editing an existing one, the app’s own UI can guide them through the specific fields and validation logic required by that Function. This reduces friction, eliminates the need to switch back to the generic discount UI, and lets developers showcase the unique value of their discount logic.

How to Implement: Registering App Intents

  • Build a Discounts UI Extension – If you already have a UI extension for discount settings, it will be auto‑promoted. No extra registration needed.
  • Add an intent entry in shopify-intent.json – Choose one of the two targets:
  • admin.app.intent.link – points to an existing React Router page in your admin app.
  • admin.app.intent.render – renders a focused inline UI extension (requires API version 2026-04 or later).
  • Map the intent to a Function – Include a matchValue that matches the functionId of the Shopify Function handling the discount type.
  • Define the value schema – For edit flows, include the discount GID (gid://shopify/Discount/...) so Shopify can open the correct discount record.
  • Deploy and test – After deployment, the new intent appears in the Sidekick disambiguation picker when multiple discount apps are installed.
  • Here’s a minimal shopify-intent.json example for a create flow using a React Router page:

    { "intent": "shopify/Discount", "target": "admin.app.intent.link", "matchValue": { "functionId": "gid://shopify/Function/123456" }, "url": "/discounts/custom-create" }

    And an example for an inline edit flow (API 2026-04+):

    { "intent": "shopify/Discount", "target": "admin.app.intent.render", "matchValue": { "functionId": "gid://shopify/Function/123456" }, "schema": { "type": "object", "properties": { "discount_gid": { "type": "string" } } } }

    Remember that each intent counts toward the per‑app intent limit, so register only the flows you truly need.

    Action Checklist for Developers

  • Verify your app uses Shopify Functions for discount types.
  • Decide whether you want a full‑page React Router flow (admin.app.intent.link) or an inline extension (admin.app.intent.render).
  • Update shopify-intent.json with the appropriate target, matchValue, and schema.
  • Ensure your app’s API version is 2026-04 or later if you use the render target.
  • Test the flow in the web admin; mobile support for link intents is still pending, so advise merchants to use the desktop UI for editing.
  • Publish the update and monitor the disambiguation picker to confirm the intent appears as expected.
  • Conclusion & Next Steps

    Shopify’s new discount app intents give developers a direct line to merchants’ discount workflows, reducing friction and increasing the perceived value of Function‑backed discounts. While existing apps need no immediate changes, taking advantage of intents positions your app for deeper Sidekick integration and a more polished merchant experience. Start by adding the intent registration to your next release, test in the web admin, and watch merchants enjoy a seamless, app‑driven discount journey.

    Ready to boost your discount app’s visibility? Register your intent today and let Shopify’s Sidekick guide merchants straight to your custom flow.

    Tags
    Sources

    Related Articles

    App Security Update: Mandatory IP Allowlist, Bulk Ops Changes, and Upcoming MFA for Shopify Partners

    App Security Update: Mandatory IP Allowlist, Bulk Ops Changes, and Upcoming MFA for Shopify Partners

    Shopify now requires all public apps that call the Admin API to enable an IP allowlist by Nov 20 2026, tightens bulk‑operations rules, and will enforce MFA for partner accounts. Learn who’s impacted and how to comply today.

    November 14, 20264 min
    Unlock Transparency: The New Store Activity Log Lets You Track Every Change

    Unlock Transparency: The New Store Activity Log Lets You Track Every Change

    Shopify’s rebuilt Store activity log centralizes every modification—from products to payments—into one searchable timeline. Learn what’s new, who can see it, and how merchants and developers can act today.

    November 13, 20264 min
    Custom Draft Order Discounts Now Respect Presentment Currency

    Custom Draft Order Discounts Now Respect Presentment Currency

    Shopify now calculates custom draft‑order discounts in the draft’s presentment currency instead of the shop’s default. Learn what this means for merchants, developers, and how to update your workflow today.

    November 13, 20264 min
    Checkout Functions Get Smarter: `cart.deliverableLine` Now Includes Cost Modeling and Direct Cart Line Links

    Checkout Functions Get Smarter: `cart.deliverableLine` Now Includes Cost Modeling and Direct Cart Line Links

    Shopify’s latest checkout function update adds cost modeling to `cart.deliverableLine` inputs and ties them directly to their originating cart lines. Learn what this means for developers, how to adjust your code, and the best practices to stay compliant.

    November 13, 20264 min