---
title: About admin intents
description: Learn about admin intents
source_url:
  html: 'https://shopify.dev/docs/apps/build/admin/admin-intents'
  md: 'https://shopify.dev/docs/apps/build/admin/admin-intents.md'
---

ExpandOn this page

* [Requirements](https://shopify.dev/docs/apps/build/admin/admin-intents.md#requirements)
* [How admin intents work](https://shopify.dev/docs/apps/build/admin/admin-intents.md#how-admin-intents-work)
* [Supported resources](https://shopify.dev/docs/apps/build/admin/admin-intents.md#supported-resources)
* [Create a Shopify resource](https://shopify.dev/docs/apps/build/admin/admin-intents.md#create-a-shopify-resource)
* [Edit an existing Shopify resource](https://shopify.dev/docs/apps/build/admin/admin-intents.md#edit-an-existing-shopify-resource)
* [Benefits](https://shopify.dev/docs/apps/build/admin/admin-intents.md#benefits)
* [Developer tools and resources](https://shopify.dev/docs/apps/build/admin/admin-intents.md#developer-tools-and-resources)

# About admin intents

![Admin intents create collection workflow](https://shopify.dev/assets/assets/images/admin/admin-intents/admin-intents-create-collection-bqfuEvyn.png)

Admin intents enable you to seamlessly launch Shopify's native resource editors directly from your app without breaking merchant context. This API bridges the gap between your app's functionality and Shopify's polished admin experience, allowing merchants to create and edit core resources while staying within your app's workflow.

With a single line of code, you can provide merchants access to the same feature-complete editors they already know and love, eliminating the need to build custom admin interfaces.

***

## Requirements

Prerequisites:

* [Create an app](https://shopify.dev/docs/apps/build/scaffold-app) or create an [admin UI extension](https://shopify.dev/docs/apps/build/purchase-options/subscriptions/subscriptions-app/extensions#admin-ui-extension).
* For app home, the latest version of [App Bridge](https://shopify.dev/docs/api/app-home).
* For admin UI extensions, at least API version `2025-10`.

***

## How admin intents work

Admin intents work through simple API calls that launch Shopify's native resource editors as contextual overlays. When a merchant completes their action, they return directly to your app with all changes automatically reflected.

## How to call intents from your app

```js
/* Create a new Shopify collection from your app */
shopify.intents.invoke('create:shopify/Collection');


/* Launch the native product editor for a specific product */
shopify.intents.invoke('edit:shopify/Product', {
  value: 'gid://shopify/Product/123445'
});
```

***

## Supported resources

Admin intents support all core Shopify resources:

* **Products** - Launch the full product editor with variants, SEO, and media handling.
* **Collections** - Create and modify product collections with advanced filtering.
* **Customers** - Edit customer profiles and manage customer data.
* **Catalogs** - Manage product catalogs and their organization.
* **Metaobjects** - Handle custom data structures seamlessly.
* **Metafields** - Manage additional resource data without custom forms.
* **Markets** - Configure market-specific settings and localization.
* **Discounts** - Create and manage promotional campaigns.

***

## Create a Shopify resource

Create a Shopify resource (for example, `Product`, `Customer`, `Market`) from your app home or admin UI extension by calling the intents API.

![Admin intents create product workflow](https://shopify.dev/assets/assets/images/admin/admin-intents/admin-intents-create-product-C-VzPAG-.png)

## Create a Shopify resource from the Intents API

```js
shopify.intents.invoke('create:shopify/Product');
```

***

## Edit an existing Shopify resource

Edit an existing Shopify resource (for example, `Product`, `Customer`, `Market`) from your app home or admin UI extension by calling the intents API with the `edit` parameter and a valid resource ID.

![Admin intents edit discount workflow](https://shopify.dev/assets/assets/images/admin/admin-intents/admin-intents-edit-discount-DZfjpClU.png)

## Edit a Shopify resource from the Intents API

```js
shopify.intents.invoke('edit:shopify/Discount', {
  value: 'gid://shopify/Discount/123445'
});
```

***

## Benefits

### Faster development

Build on Shopify's proven admin interface instead of recreating it. Focus on your app's unique features while leveraging years of UX research built into Shopify's editors.

### Better merchant experience

Keep merchants engaged by eliminating context switching. They can manage core resources without losing their place in your workflow.

### Consistent interface

Provide merchants with the familiar, polished experience they expect while maintaining your app's branding and flow.

***

## Developer tools and resources

[Shopify App Bridge intents API reference\
\
](https://shopify.dev/docs/api/app-home/apis/intents)

[Consult the intents API reference for Shopify App Bridge.](https://shopify.dev/docs/api/app-home/apis/intents)

[Admin UI extensions intents API reference\
\
](https://shopify.dev/docs/api/admin-extensions/api/intents)

[Consult the intents API reference for admin UI extensions.](https://shopify.dev/docs/api/admin-extensions/api/intents)

***

* [Requirements](https://shopify.dev/docs/apps/build/admin/admin-intents.md#requirements)
* [How admin intents work](https://shopify.dev/docs/apps/build/admin/admin-intents.md#how-admin-intents-work)
* [Supported resources](https://shopify.dev/docs/apps/build/admin/admin-intents.md#supported-resources)
* [Create a Shopify resource](https://shopify.dev/docs/apps/build/admin/admin-intents.md#create-a-shopify-resource)
* [Edit an existing Shopify resource](https://shopify.dev/docs/apps/build/admin/admin-intents.md#edit-an-existing-shopify-resource)
* [Benefits](https://shopify.dev/docs/apps/build/admin/admin-intents.md#benefits)
* [Developer tools and resources](https://shopify.dev/docs/apps/build/admin/admin-intents.md#developer-tools-and-resources)