Use app intents for your discount app

Apps that create new discount types using Shopify Functions can now register shopify/Discount app intents. This lets Sidekick launch an app’s create and edit flows and promote them in the disambiguation picker.

Apps can register an intent using either of these targets:

• admin.app.intent.link navigates to an existing page in a React Router app.
• admin.app.intent.render renders a focused Admin UI extension inline. This target requires API version 2026-04 or later.

Discounts UI extensions using admin.discount-details.function-settings.render are promoted automatically.

Mobile support: admin.app.intent.link discount flows are currently supported in Shopify admin on the web. App-link discounts can appear in the Shopify mobile app’s discount list, but tapping one doesn’t open the app’s edit flow. Until mobile support is available, merchants should use Shopify admin on the web to open and edit these discounts.

What changed

The shopify/Discount intent now supports create and edit actions for app discount flows.

Registration uses the shopify-intent.json meta-schema and references the shopify/discount.json baseline schema. A matchValue on functionId maps each intent to a specific Shopify Function implementation, allowing apps with multiple implementations to register a flow for each one. The intent’s value schema carries the discount GID for edit flows.

When a request doesn’t identify a specific discount type or function implementation, merchants can select from the available flows in the disambiguation picker.

Each registered intent counts toward the per-app intent limit.

The extension.ui.paths property continues to work. However, we encourage apps to declare app intents for deeper Sidekick integration across both create and edit flows.

Who’s affected

This applies to apps that create new discount types using Shopify Functions.

Existing apps continue to work unchanged, and no migration is required. Apps that don’t create Function-backed discount types are unaffected.

Why this matters

Merchants can consistently land in the specialized app flow for the discount type they’re creating or editing instead of being routed to Shopify’s default discount UI.

Apps control which Shopify Function implementations are offered and can use either an existing React Router page or a focused inline UI extension.

What to do

No action is required for existing apps.

To promote a discount flow in Sidekick and the disambiguation picker:

• Build a discounts UI extension, which is promoted automatically.
• Register admin.app.intent.link for an existing React Router discount UI.
• Register admin.app.intent.render to provide a focused inline UI extension.

See Build app actions with Sidekick for configuration examples and the Intents API reference for the complete contract.