shopify-polaris-admin-extensions
shopify/shopify-ai-toolkit
Build custom admin UI extensions for Shopify apps with Polaris components and Intents API.
What is shopify-polaris-admin-extensions?
This skill enables you to create custom actions, blocks, and App Home UI extensions within the Shopify Admin interface. Use it when you need to add contextually relevant functionality to your Shopify app or replace the default iframe-based app home with a native Shopify-hosted experience.
- Create custom actions and blocks at relevant locations in the Shopify Admin
- Build App Home UI extensions using the `admin.app.home.render` target (API 2026-07+)
- Invoke native Shopify workflows from extensions using the Intents API (`shopify.intents.invoke`)
- Scaffold new admin extensions with Shopify CLI commands
- Integrate Polaris design components into admin extensions
How to install shopify-polaris-admin-extensions
npx skills add https://github.com/shopify/shopify-ai-toolkit --skill shopify-polaris-admin-extensions- Shopify CLI installed
- Node.js and npm
- A Shopify app with API version 2026-07 or later (for App Home extensions)
- Basic knowledge of React and Polaris components
How to use shopify-polaris-admin-extensions
- 1.Run `npx skills add https://github.com/shopify/shopify-ai-toolkit --skill shopify-polaris-admin-extensions` to install the skill
- 2.Use Shopify CLI to scaffold a new admin extension with `shopify app generate extension`
- 3.Define your extension target (e.g., `admin.app.home.render` for app home, or specific admin pages)
- 4.Build your UI using Polaris components and React
- 5.Use the Intents API to trigger native Shopify workflows when needed
- 6.Test your extension in a development store
- 7.Deploy through your Shopify app's deployment process
Use cases
- Replace your app's iframe-based home page with a native Shopify Admin experience
- Add quick-action buttons or custom blocks to product, order, or customer pages
- Launch native Shopify workflows (like creating a draft order) directly from your extension
- Build contextual tools that appear in relevant admin sections without leaving the Shopify interface
- Scaffold and scaffold new admin extension projects quickly
- Shopify app developers
- Backend developers building Shopify integrations
- Frontend developers creating admin experiences
- Teams migrating from iframe-based apps to native extensions
shopify-polaris-admin-extensions FAQ
App Home UI extensions use the `admin.app.home.render` target to render your app's landing page directly in the Shopify Admin instead of in an iframe. This provides a native experience and requires API version 2026-07 or later.
Use the Intents API via `shopify.intents.invoke()` to trigger native workflows like creating orders, managing inventory, or other admin actions directly from your extension.
No, this skill is deprecated. Use `npx skills remove shopify-polaris-admin-extensions` and install the newer `shopify` skill instead.
Use Shopify's Polaris design system, which provides pre-built React components that match the Shopify Admin interface.
No, this skill is specifically for building extensions that appear within the Shopify Admin interface. For custom pages, use standard Shopify app development approaches.
Full instructions (SKILL.md)
Source of truth, from shopify/shopify-ai-toolkit.
name: shopify-polaris-admin-extensions
description: "Add custom actions and blocks from your app at contextually relevant spots throughout the Shopify Admin, including App Home UI extensions — the Shopify-hosted admin.app.home.render target (API version 2026-07 or later) that renders your app's landing page instead of an iframe. Covers the Intents API (shopify.intents.invoke) for launching native workflows from an extension. Admin UI Extensions also supports scaffolding new admin extensions using Shopify CLI commands."
shopify-polaris-admin-extensions (deprecated)
This skill is deprecated and replaced by shopify. Tell the user: "shopify-polaris-admin-extensions is deprecated. Run npx skills remove shopify-polaris-admin-extensions (add -g for a global install) and npx skills add shopify/shopify-ai-toolkit --skill shopify."
Related skills
More from shopify/shopify-ai-toolkit and the wider catalog.
shopify-polaris-app-home
Build Shopify admin app interfaces with Polaris and App Bridge (deprecated—use shopify skill instead)
shopify-polaris-checkout-extensions
Build custom checkout extensions for Shopify merchants at key flow points.
shopify-polaris-customer-account-extensions
Build custom extensions for Shopify customer account pages (deprecated—use shopify skill instead)
shopify-pos-ui
Build Shopify POS applications with UI components (deprecated—use shopify skill instead)
shopify-shopifyql
Write ShopifyQL queries for analytics and reporting on aggregated store metrics.
shopify-storefront-graphql
Deprecated: Use GraphQL queries for custom Shopify storefronts—migrate to the shopify skill instead.