--- title: Extension Targets description: >- This is a list of all the available extension targets for Admin App Extensions. api_version: 2023-10 api_name: admin-extensions source_url: html: 'https://shopify.dev/docs/api/admin-extensions/2023-10/api/extension-targets' md: >- https://shopify.dev/docs/api/admin-extensions/2023-10/api/extension-targets.md --- # Extension Targets This is a list of all the available extension targets for Admin App Extensions. ## ExtensionTargets * admin.customers.segmentation-templates.render RenderExtension< CustomerSegmentTemplateApi<'admin.customers.segmentation-templates.render'>, CustomerSegmentTemplateComponent > required Renders a [`CustomerSegmentTemplate`](https://shopify.dev/docs/api/admin-extensions/components/customersegmenttemplate) in the [customer segment editor](https://help.shopify.com/en/manual/customers/customer-segmentation/customer-segments). * admin.product-details.block.render RenderExtension< BlockExtensionApi<'admin.product-details.block.render'>, AllComponents > required Renders an Admin Block in the product details page. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.order-details.block.render RenderExtension< BlockExtensionApi<'admin.order-details.block.render'>, AllComponents > required Renders an Admin Block in the order details page. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.customer-details.block.render RenderExtension< BlockExtensionApi<'admin.customer-details.block.render'>, AllComponents > required Renders an Admin Block in the customer details page. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.product-details.action.render RenderExtension< ActionExtensionApi<'admin.product-details.action.render'>, AllComponents > required Renders an Admin Action in the product details page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.order-details.action.render RenderExtension< ActionExtensionApi<'admin.order-details.action.render'>, AllComponents > required Renders an Admin Action in the order details page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.customer-details.action.render RenderExtension< ActionExtensionApi<'admin.customer-details.action.render'>, AllComponents > required Renders an Admin Action in the customer details page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.customer-segment-details.action.render RenderExtension< ActionExtensionApi<'admin.customer-segment-details.action.render'>, AllComponents > required Renders an Admin Action in the customer segment details page. Open this extension from the "Use segment" button. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.product-index.action.render RenderExtension< ActionExtensionApi<'admin.product-index.action.render'>, AllComponents > required Renders an Admin Action in the product index page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.order-index.action.render RenderExtension< ActionExtensionApi<'admin.order-index.action.render'>, AllComponents > required Renders an Admin Action in the order index page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.customer-index.action.render RenderExtension< ActionExtensionApi<'admin.customer-index.action.render'>, AllComponents > required Renders an Admin Action in the customer index page. Open this extension from the "More Actions" menu. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.product-index.selection-action.render RenderExtension< ActionExtensionApi<'admin.product-index.selection-action.render'>, AllComponents > required Renders an Admin Action in the product index page when multiple resources are selected. Open this extension from the "More Actions" menu of the resource list. The resource ids are available to this extension at runtime. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.order-index.selection-action.render RenderExtension< ActionExtensionApi<'admin.order-index.selection-action.render'>, AllComponents > required Renders an Admin Action in the order index page when multiple resources are selected. Open this extension from the "More Actions" menu of the resource list. The resource ids are available to this extension at runtime. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.customer-index.selection-action.render RenderExtension< ActionExtensionApi<'admin.customer-index.selection-action.render'>, AllComponents > required Renders an Admin Action in the customer index page when multiple resources are selected. Open this extension from the "More Actions" menu of the resource list. The resource ids are available to this extension at runtime. See the [list of available components](https://shopify.dev/docs/api/admin-extensions/components). * admin.product-details.configuration.render RenderExtension< ProductDetailsConfigurationApi<'admin.product-details.configuration.render'>, ProductConfigurationComponents > required Renders Product Configuration on product details and product variant details * admin.product-variant-details.configuration.render RenderExtension< ProductVariantDetailsConfigurationApi<'admin.product-variant-details.configuration.render'>, ProductConfigurationComponents > required ### RenderExtension ```ts export interface RenderExtension< Api, AllowedComponents extends RemoteComponentType< string, any, any > = RemoteComponentType, > { ( connection: RenderExtensionConnection, api: Api, ): void | Promise; } ``` ### CustomerSegmentTemplateApi * i18n Utilities for translating content according to the current localization of the admin. More info - https://shopify.dev/docs/apps/checkout/best-practices/localizing-ui-extensions ```ts I18n ``` * \_\_enabledFeatures ```ts "b2bEnabled"[] ``` * extension The identifier of the running extension target. ```ts { target: ExtensionTarget; } ``` * intents Provides information to the receiver the of an intent. ```ts Intents ``` * navigation Provides methods to navigate to other features in the Admin. ```ts Navigation ``` * query Used to query the Admin GraphQL API ```ts (query: string, options?: { variables?: Variables; version?: Omit; }) => Promise<{ data?: Data; errors?: GraphQLError[]; }> ``` ```ts export interface CustomerSegmentTemplateApi< ExtensionTarget extends AnyExtensionTarget, > extends StandardApi { /* Utilities for translating content according to the current `localization` of the admin. */ i18n: I18n; /** @private */ __enabledFeatures: CustomerSegmentationFeature[]; } ``` ### I18n * formatNumber Returns a localized number. This function behaves like the standard \`Intl.NumberFormat()\` with a style of \`decimal\` applied. It uses the buyer's locale by default. ```ts (number: number | bigint, options?: { inExtensionLocale?: boolean; } & NumberFormatOptions) => string ``` * formatCurrency Returns a localized currency value. This function behaves like the standard \`Intl.NumberFormat()\` with a style of \`currency\` applied. It uses the buyer's locale by default. ```ts (number: number | bigint, options?: { inExtensionLocale?: boolean; } & NumberFormatOptions) => string ``` * formatDate Returns a localized date value. This function behaves like the standard \`Intl.DateTimeFormatOptions()\` and uses the buyer's locale by default. Formatting options can be passed in as options. ```ts (date: Date, options?: { inExtensionLocale?: boolean; } & DateTimeFormatOptions) => string ``` * translate Returns translated content in the buyer's locale, as supported by the extension. - \`options.count\` is a special numeric value used in pluralization. - The other option keys and values are treated as replacements for interpolation. - If the replacements are all primitives, then \`translate()\` returns a single string. - If replacements contain UI components, then \`translate()\` returns an array of elements. ```ts I18nTranslate ``` ```ts export interface I18n { /** * Returns a localized number. * * This function behaves like the standard `Intl.NumberFormat()` * with a style of `decimal` applied. It uses the buyer's locale by default. * * @param options.inExtensionLocale - if true, use the extension's locale */ formatNumber: ( number: number | bigint, options?: {inExtensionLocale?: boolean} & Intl.NumberFormatOptions, ) => string; /** * Returns a localized currency value. * * This function behaves like the standard `Intl.NumberFormat()` * with a style of `currency` applied. It uses the buyer's locale by default. * * @param options.inExtensionLocale - if true, use the extension's locale */ formatCurrency: ( number: number | bigint, options?: {inExtensionLocale?: boolean} & Intl.NumberFormatOptions, ) => string; /** * Returns a localized date value. * * This function behaves like the standard `Intl.DateTimeFormatOptions()` and uses * the buyer's locale by default. Formatting options can be passed in as * options. * * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat0 * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat#using_options * * @param options.inExtensionLocale - if true, use the extension's locale */ formatDate: ( date: Date, options?: {inExtensionLocale?: boolean} & Intl.DateTimeFormatOptions, ) => string; /** * Returns translated content in the buyer's locale, * as supported by the extension. * * - `options.count` is a special numeric value used in pluralization. * - The other option keys and values are treated as replacements for interpolation. * - If the replacements are all primitives, then `translate()` returns a single string. * - If replacements contain UI components, then `translate()` returns an array of elements. */ translate: I18nTranslate; } ``` ### I18nTranslate This defines the i18n.translate() signature. ```ts export interface I18nTranslate { /** * This returns a translated string matching a key in a locale file. * * @example translate("banner.title") */ ( key: string, options?: {[placeholderKey: string]: ReplacementType | string | number}, ): ReplacementType extends string | number ? string : (string | ReplacementType)[]; } ``` ### ExtensionTarget ```ts keyof ExtensionTargets ``` ### Intents * launchUrl The URL that was used to launch the intent. ```ts string | URL ``` ```ts export interface Intents { /** * The URL that was used to launch the intent. */ launchUrl?: string | URL; } ``` ### Navigation * navigate A method to navigate to a specific route. ```ts (url: string | URL) => void ``` ```ts export interface Navigation { /** * A method to navigate to a specific route. */ navigate: (url: string | URL) => void; } ``` ### Data * selected Information about the currently viewed or selected items. ```ts { id: string; }[] ``` ```ts export interface Data { /** * Information about the currently viewed or selected items. */ selected: {id: string}[]; } ``` ### ApiVersion Union of supported API versions ```ts '2023-04' | '2023-07' | '2023-10' | 'unstable' ``` ### CustomerSegmentTemplateComponent ```ts CustomerSegmentTemplateComponent ``` ### BlockExtensionApi * data Information about the currently viewed or selected items. ```ts Data ``` * extension The identifier of the running extension target. ```ts { target: ExtensionTarget; } ``` * i18n Utilities for translating content according to the current localization of the admin. More info - https://shopify.dev/docs/apps/checkout/best-practices/localizing-ui-extensions ```ts I18n ``` * intents Provides information to the receiver the of an intent. ```ts Intents ``` * navigation Provides methods to navigate to other features in the Admin. ```ts Navigation ``` * query Used to query the Admin GraphQL API ```ts (query: string, options?: { variables?: Variables; version?: Omit; }) => Promise<{ data?: Data; errors?: GraphQLError[]; }> ``` ```ts export interface BlockExtensionApi extends StandardApi { /** * Information about the currently viewed or selected items. */ data: Data; } ``` ### AllComponents See the \[list of available components]\(/docs/api/admin-extensions/components). ```ts AllComponents ``` ### ActionExtensionApi * close Closes the extension. Calling this method is equivalent to the merchant clicking the "x" in the corner of the overlay. ```ts () => void ``` * data Information about the currently viewed or selected items. ```ts Data ``` * extension The identifier of the running extension target. ```ts { target: ExtensionTarget; } ``` * i18n Utilities for translating content according to the current localization of the admin. More info - https://shopify.dev/docs/apps/checkout/best-practices/localizing-ui-extensions ```ts I18n ``` * intents Provides information to the receiver the of an intent. ```ts Intents ``` * navigation Provides methods to navigate to other features in the Admin. ```ts Navigation ``` * query Used to query the Admin GraphQL API ```ts (query: string, options?: { variables?: Variables; version?: Omit; }) => Promise<{ data?: Data; errors?: GraphQLError[]; }> ``` ```ts export interface ActionExtensionApi extends StandardApi { /** * Closes the extension. Calling this method is equivalent to the merchant clicking the "x" in the corner of the overlay. */ close: () => void; /** * Information about the currently viewed or selected items. */ data: Data; } ``` ### ProductDetailsConfigurationApi * data ```ts { product: Product; app: { launchUrl: string; applicationUrl: string; }; } ``` * extension The identifier of the running extension target. ```ts { target: ExtensionTarget; } ``` * i18n Utilities for translating content according to the current localization of the admin. More info - https://shopify.dev/docs/apps/checkout/best-practices/localizing-ui-extensions ```ts I18n ``` * intents Provides information to the receiver the of an intent. ```ts Intents ``` * navigation Provides methods to navigate to other features in the Admin. ```ts Navigation ``` * query Used to query the Admin GraphQL API ```ts (query: string, options?: { variables?: Variables; version?: Omit; }) => Promise<{ data?: Data; errors?: GraphQLError[]; }> ``` ```ts export interface ProductDetailsConfigurationApi< ExtensionTarget extends AnyExtensionTarget, > extends StandardApi { data: { /* The product currently being viewed in the admin. */ product: Product; app: { launchUrl: string; applicationUrl: string; }; }; } ``` ### Product * id ```ts string ``` * title ```ts string ``` * handle ```ts string ``` * status ```ts "ACTIVE" | "ARCHIVED" | "DRAFT" ``` * totalVariants ```ts number ``` * totalInventory ```ts number ``` * hasOnlyDefaultVariant ```ts boolean ``` * onlineStoreUrl ```ts string ``` * options ```ts { id: string; name: string; position: number; values: string[]; }[] ``` * productType ```ts string ``` * productCategory ```ts string ``` * productComponents ```ts ProductComponent[] ``` ```ts interface Product { id: string; title: string; handle: string; status: 'ACTIVE' | 'ARCHIVED' | 'DRAFT'; totalVariants: number; totalInventory: number; hasOnlyDefaultVariant: boolean; onlineStoreUrl?: string; options: { id: string; name: string; position: number; values: string[]; }[]; productType: string; productCategory?: string; productComponents: ProductComponent[]; } ``` ### ProductComponent * id ```ts string ``` * title ```ts string ``` * featuredImage ```ts { id?: string; url?: string; altText?: string; } ``` * totalVariants ```ts number ``` * productUrl ```ts string ``` * componentVariantsCount ```ts number ``` * nonComponentVariantsCount ```ts number ``` ```ts export interface ProductComponent { id: string; title: string; featuredImage?: { id?: string | null; url?: string | null; altText?: string | null; } | null; totalVariants: number; productUrl: string; componentVariantsCount: number; nonComponentVariantsCount: number; } ``` ### ProductConfigurationComponents ```ts ProductConfigurationComponents ``` ### ProductVariantDetailsConfigurationApi * data ```ts { variant: ProductVariant; app: { launchUrl: string; applicationUrl: string; }; } ``` * extension The identifier of the running extension target. ```ts { target: ExtensionTarget; } ``` * i18n Utilities for translating content according to the current localization of the admin. More info - https://shopify.dev/docs/apps/checkout/best-practices/localizing-ui-extensions ```ts I18n ``` * intents Provides information to the receiver the of an intent. ```ts Intents ``` * navigation Provides methods to navigate to other features in the Admin. ```ts Navigation ``` * query Used to query the Admin GraphQL API ```ts (query: string, options?: { variables?: Variables; version?: Omit; }) => Promise<{ data?: Data; errors?: GraphQLError[]; }> ``` ```ts export interface ProductVariantDetailsConfigurationApi< ExtensionTarget extends AnyExtensionTarget, > extends StandardApi { data: { /* The product variant currently being viewed in the admin. */ variant: ProductVariant; app: { launchUrl: string; applicationUrl: string; }; }; } ``` ### ProductVariant * id ```ts string ``` * sku ```ts string ``` * barcode ```ts string ``` * title ```ts string ``` * displayName ```ts string ``` * price ```ts string ``` * compareAtPrice ```ts string ``` * taxable ```ts boolean ``` * taxCode ```ts string ``` * weight ```ts number ``` * selectedOptions ```ts { name: string; value: string; }[] ``` * productVariantComponents ```ts ProductVariantComponent[] ``` ```ts interface ProductVariant { id: string; sku: string; barcode: string; title: string; displayName: string; price: string; compareAtPrice: string; taxable: boolean; taxCode: string; weight: number; selectedOptions: { name: string; value: string; }[]; productVariantComponents: ProductVariantComponent[]; } ``` ### ProductVariantComponent * id ```ts string ``` * displayName ```ts string ``` * title ```ts string ``` * sku ```ts string ``` * image ```ts { id?: string; url?: string; altText?: string; } ``` * productVariantUrl ```ts string ``` * selectedOptions ```ts { name: string; value: string; }[] ``` ```ts export interface ProductVariantComponent { id: string; displayName: string; title: string; sku?: string; image?: { id?: string | null; url?: string | null; altText?: string | null; } | null; productVariantUrl: string; selectedOptions: { name: string; value: string; }[]; } ```