Admin API / Intents

7 new intents added that open Settings with pinpoint precision
Coverage expands to notifications, payments, shipping, and business info

With a single API call from your app, the relevant section of Settings in the Shopify admin opens in an overlay and auto-scrolls to the field that needs editing. An extension of the initial March release.

On this page
  1. Understand it in 30 seconds: what's new
  2. The 7 new intents at a glance
  3. How it works: launch the overlay with one API call
  4. How it relates to the March release
  5. 5 key points for developers
  6. 3 use cases you can put to work
  7. A one-line summary for your pitch

1Understand it in 30 seconds: what's new

From your app, getting a merchant to 'edit this setting'— Settings intents that can guide them there with a single API call— now,
across notifications / payments / gift cards / shipping / business info, 7 new typeshave been added.

Before: left entirely to the merchant

Guide them in prose—"open Settings > ○○ > △△ and edit it"—and they get lost or skip a setting.

Now: the app takes them there directly

Just call the intent from your app, and the target Settings opens in an overlay and auto-scrolls to the card that needs editing.

2The 7 new intents at a glance

Notifications

Notifications

edit:settings/NotificationsSenderEmail

Opens the sender address settings for notification emails.

Notifications

edit:settings/NotificationsStaff

Opens notification settings for staff.

Payments and gift cards

Payments

edit:settings/PaymentCaptureMethod

Opens the payment capture method settings (automatic, manual, and so on).

Gift cards

edit:settings/GiftCardExpiration

Opens the gift card expiration settings.

Delivery

Delivery

create:shopify/DeliveryProfile

Opens the screen for creating a new Delivery Profile.

Delivery

edit:shopify/DeliveryProfile

Opens the edit screen for an existing Delivery Profile.

Business

Business

edit:settings/BusinessDetails

Opens the edit screen for business information (business details).

3How it works: launch the overlay with one API call

App "Set up your notifications" Issue intent edit:settings/... A single API call Shopify Admin Routes the intent Identifies the relevant Settings Pushes onto the page stack Scrolls to the target card contextual overlay Settings overlay Field to edit (already scrolled directly) Merchant Edits without hunting around
Settings appears on top of the app screen contextual overlayIt opens as a context-preserving overlay, and once editing is done the merchant can return to their work in the app — avoiding the experience of being "thrown into Settings and having your workflow interrupted."

4How it relates to the March release

ItemInitial release (March 2026)This release (May 2026)
Positioning First introduction of Settings intents Expansion Addition of supported Settings categories
Number of intents added Not specified 7 types
Supported categories Not specified Notifications/Payments/Gift cards/Delivery/Business
Behavior pattern Scrolls to the target card on the page stack Follows the same behavior

※ This article does not specify exactly which intents shipped in the initial release. For details, see "Read up on admin intents" and "supported Shopify resources."

55 key points for developers

intent

1. Intents follow a "verb:target" naming convention

edit: and create: as the two verbs, with settings/... and shopify/... as the two target families. Note that only Delivery Profile belongs to the shopify/ namespace.

2. Because it's an overlay, the app context is never lost

An overlay on the page stack. After finishing editing Settings, the merchant can continue working in the app. The aim is to make the prompt-to-settings → return-to-app flow seamless.

3. The key is "auto-scrolling to the relevant card"

It doesn't just open the Settings page — it scrolls directly to the specific card that needs editing. The design eliminates the merchant's "now where do I fix this?" search time.

API ?

4. This article doesn't cover the specifics of how to invoke it

Only "With a single API call" is stated. No specific endpoint, SDK function, or parameter spec is given in this article. For details, be sure to consult the "Read up on admin intents" documentation.

edit create

5. Only Delivery Profile supports both the create and edit verbs

While the others only support edit: , the delivery profile also provides create:shopify/DeliveryProfile as well.Being able to branch in two stages — "create it if it doesn't exist, edit it if it does" —is what this means at the app-implementation level.

6Three use cases you can apply to your business

USE CASE 1

Eliminate the "it never arrives because the sender isn't set" failure in notification apps

Challenge
In order-notification and customer-facing email apps, incidents occur where notifications fail to send or get flagged as spoofing because the Sender Email is unset or invalid.
Solution
On the app's first launch or when a notification failure is detected, issue edit:settings/NotificationsSenderEmail and take the merchant directly to the sender email address setting.
Impact
Fewer support inquiries (the "notifications aren't arriving" type) and a better onboarding drop-off rate.
Technical note
For missed staff notifications, using edit:settings/NotificationsStaff as a pair improves the coverage of your operational settings.
JP US
USE CASE 2

Guide users all the way to "create a new profile" in one click in shipping-rule suggestion apps

Challenge
Even when a cross-border commerce or 3PL integration app suggests "let's move this product group to a separate delivery profile," the merchant can't reach the Delivery Profile creation screen, so the suggestion stalls.
Solution
Place a CTA in the suggestion UI, and when it's tapped, issue create:shopify/DeliveryProfile(for new) /edit:shopify/DeliveryProfile(for existing). The merchant can edit it right there on the spot.
Impact
A better suggestion execution rate (adoption rate) = higher app retention and a stronger value proposition.
Technical note
Delivery Profile is the only one with both the create and edit verbs.Just switch the intent based on whether you hold a profile ID— that's all it takes.
USE CASE 3

Detect "incomplete business information" in accounting/invoicing apps → provide an on-the-spot path to fix it

Challenge
In invoicing, receipt, and tax-filing apps, if the store's Business Details (company name, address, registration number, etc.) are incomplete, the output is illegal or undermines customer trust.
Solution
Validate on the app side → if something is incomplete, use edit:settings/BusinessDetails to scroll directly to the relevant card and have them fix it on the spot.
Impact
Reduce support tickets and rejections caused by merchants' missed settings. Also helps when reviewing payment capture operations. edit:settings/PaymentCaptureMethod can be used in the same way.
Technical notes
In gift card sales apps, edit:settings/GiftCardExpiration , you can also build a consistency-check flow for expiration policies using the same pattern.

7One-line summary for pitches

"With just a single API call from your app, in Shopify's Settings,you can take the merchant directly to the relevant fieldSeven new intents added.
Apps that handle notifications, payments, gift cards, shipping, and business informationcan structurally reduce "missed-setting incidents" and "onboarding drop-off"a major improvement."