Admin intents

Admin intents let you launch Shopify's native resource editors directly from your app. Instead of building custom forms for creating or editing Shopify resources, you call a single API and Shopify opens the same editors merchants already know. When they're done, they return to your app.

This guide covers how admin intents work, what you can do with them, and where they're available.

Anchor to How it worksHow it works

Your app calls shopify.intents.invoke() with an action (create or edit) and a resource type. Shopify opens the native resource editor as a contextual overlay. The merchant completes their action using the full-featured editor, and control returns to your app with the result.

shopify.intents.invoke('create:shopify/Collection');

Because the editors are built and maintained by Shopify, your app automatically benefits from new fields, validation rules, and UX improvements without any code changes.

Admin intents are available in two contexts:

App Home: Requires the latest version of App Bridge.
Admin UI extensions: Requires API version 2026-04 or later.

Anchor to Creating resourcesCreating resources

You can open the native editor for creating a new resource by specifying the create action and a resource type.

Create a new product

const result = await shopify.intents.invoke('create:shopify/Product');

The native product editor opened from an app using admin intents.

Anchor to Editing resourcesEditing resources

You can open the native editor for an existing resource by specifying the edit action, a resource type, and a resource GID.

Edit an existing discount

const result = await shopify.intents.invoke('edit:shopify/Discount', {

value: 'gid://shopify/Discount/123445',

});

The native discount editor opened from an app using admin intents.

Anchor to Supported resourcesSupported resources

Admin intents support the following Shopify resources:

Resource	Description	Create	Edit
Article	Blog posts published on the Online Store	Yes	Yes
Catalog	Product groupings for B2B or multi-market selling	Yes	Yes
Collection	Groups of products organized manually or by automated rules	Yes	Yes
Customer	Customer profiles with contact info, order history, and metadata	Yes	Yes
DeliveryProfile	Shipping rates and rules for products across locations and zones	Yes	Yes
Discount	Price reductions on products, orders, or shipping	Yes	Yes
Location	Physical or virtual places where merchants store inventory	Yes	Yes
Market	Geographic regions with customized pricing, languages, and domains	Yes	Yes
Menu	Navigation structures for the Online Store	Yes	Yes
MetafieldDefinition	Schemas that define custom data fields for resources	Yes	Yes
Metaobject	Custom structured data entries based on metaobject definitions	Yes	Yes
MetaobjectDefinition	Schemas that define the structure for metaobjects	Yes	Yes
Page	Static content pages on the Online Store	Yes	Yes
Product	Items sold in the store with pricing, inventory, and variants	Yes	Yes
ProductVariant	Specific combinations of product options like size and color	Yes	Yes
Settings	Store configuration like order processing, notifications, payments, gift cards, and defaults	No	Yes

Anchor to Next stepsNext steps

Explore the full intents API reference for App Home or admin UI extensions for advanced usage like handling responses and passing data parameters.

Was this page helpful?