@shopify/ui-extensions 2025.10.13 → 2025.10.14

package/src/surfaces/admin/extension-targets.ts

@@ -23,9 +23,12 @@ import type {ActionExtensionComponents} from './components/ActionExtensionCompon
 import type {PrintActionExtensionComponents} from './components/PrintActionExtensionComponents';
 import type {FunctionSettingsComponents} from './components/FunctionSettingsComponents';
 
+/**
+ * Maps extension target identifiers to their corresponding extension types. Each target represents a specific location or context in the Shopify admin where extensions can render or execute. Use these targets to define where your extension appears and what capabilities it has access to.
+ */
 export interface ExtensionTargets {
   /**
-   * Renders a  [`CustomerSegmentTemplate`](/docs/api/admin-extensions/components/customersegmenttemplate) in the [customer segment editor](https://help.shopify.com/en/manual/customers/customer-segmentation/customer-segments).
+   * A runnable target that provides [customer segment templates](/docs/apps/build/marketing-analytics/customer-segments/build-a-template-extension) in the [customer segment editor](https://help.shopify.com/manual/customers/customer-segmentation/create-customer-segments). Use this target to provide pre-built segment templates that merchants can use as starting points for creating targeted customer groups based on custom criteria.
    */
   'admin.customers.segmentation-templates.data': RunnableExtension<
     CustomerSegmentTemplateApi<'admin.customers.segmentation-templates.data'>,
@@ -34,9 +37,7 @@ export interface ExtensionTargets {
 
   // Blocks
   /**
-   * Renders an admin block in the product details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the product details page. Use this to show product-specific information, tools, or actions directly on the product page.
    */
   'admin.product-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.product-details.block.render'>,
@@ -44,9 +45,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the order details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the order details page. Use this to show order-specific information, fulfillment tools, or custom order actions.
    */
   'admin.order-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.order-details.block.render'>,
@@ -54,9 +53,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the discount details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A function settings target that appears when merchants create or edit a discount powered by your discount function, allowing them to configure function-specific settings. Use this to build custom configuration interfaces for discount function parameters.
    */
   'admin.discount-details.function-settings.render': RenderExtension<
     DiscountFunctionSettingsApi<'admin.discount-details.function-settings.render'>,
@@ -64,9 +61,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the customer details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the customer details page. Use this to show customer-specific information, loyalty data, or custom customer actions.
    */
   'admin.customer-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.customer-details.block.render'>,
@@ -74,9 +69,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the collection details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the collection details page. Use this to show collection analytics, bulk product operations, or collection-specific tools.
    */
   'admin.collection-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.collection-details.block.render'>,
@@ -84,9 +77,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the draft order details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the draft order details page. Use this to show custom pricing calculations, special order handling tools, or order-specific information.
    */
   'admin.draft-order-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.draft-order-details.block.render'>,
@@ -94,9 +85,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the abandoned checkout details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the abandoned checkout details page. Use this to show cart recovery tools, abandonment analysis, or customer re-engagement options.
    */
   'admin.abandoned-checkout-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.abandoned-checkout-details.block.render'>,
@@ -104,9 +93,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the catalog details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the catalog details page. Use this to show catalog-specific settings, market information, or synchronization tools.
    */
   'admin.catalog-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.catalog-details.block.render'>,
@@ -114,9 +101,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the company details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the company details page. Use this to show B2B customer information, credit limits, or company-specific data.
    */
   'admin.company-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.company-details.block.render'>,
@@ -124,9 +109,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the company location details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the company location details page. Use this to show location-specific information, shipping preferences, or location management tools.
    */
   'admin.company-location-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.company-location-details.block.render'>,
@@ -134,9 +117,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the gift card details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the gift card details page. Use this to show gift card balance tracking, usage history, or custom gift card metadata.
    */
   'admin.gift-card-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.gift-card-details.block.render'>,
@@ -144,9 +125,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the product variant details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that displays inline content within the product variant details page. Use this to show variant-specific data, inventory tools, or variant configuration options.
    */
   'admin.product-variant-details.block.render': RenderExtension<
     BlockExtensionApi<'admin.product-variant-details.block.render'>,
@@ -154,9 +133,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin block in the product details page.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A block target that provides custom reordering functionality on the product details page. Use this to help merchants rearrange product data.
    */
   'admin.product-details.reorder.render': RenderExtension<
     BlockExtensionApi<'admin.product-details.reorder.render'>,
@@ -165,9 +142,7 @@ export interface ExtensionTargets {
 
   // Actions
   /**
-   * Renders an admin action extension in the product details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the product details page. Use this to create workflows for processing products, syncing data, or integrating with external systems.
    */
   'admin.product-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.product-details.action.render'>,
@@ -175,9 +150,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the catalog details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the catalog details page. Use this to create workflows for catalog management, market synchronization, or data exports.
    */
   'admin.catalog-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.catalog-details.action.render'>,
@@ -185,9 +158,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the company details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the company details page. Use this to create workflows for B2B customer management, credit operations, or company data synchronization.
    */
   'admin.company-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.company-details.action.render'>,
@@ -195,9 +166,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the gift card details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the gift card details page. Use this to create workflows for gift card processing, balance adjustments, or custom gift card operations.
    */
   'admin.gift-card-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.gift-card-details.action.render'>,
@@ -205,9 +174,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the order details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the order details page. Use this to create workflows for order processing, fulfillment operations, or external system integrations.
    */
   'admin.order-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.order-details.action.render'>,
@@ -215,9 +182,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the customer details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the customer details page. Use this to create workflows for customer data management, loyalty operations, or CRM integrations.
    */
   'admin.customer-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.customer-details.action.render'>,
@@ -225,9 +190,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the customer segment details page. Open this extension from the "Use segment" button.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears from the **Use segment** button on the customer segment details page. Use this to create workflows for marketing campaigns, email operations, or segment-based actions.
    */
   'admin.customer-segment-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.customer-segment-details.action.render'>,
@@ -235,9 +198,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the product index page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the product index page. Use this to create workflows for product management, catalog operations, or inventory synchronization.
    */
   'admin.product-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.product-index.action.render'>,
@@ -245,9 +206,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the order index page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the order index page. Use this to create workflows for order management, reporting, or fulfillment operations.
    */
   'admin.order-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.order-index.action.render'>,
@@ -255,9 +214,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the customer index page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the customer index page. Use this to create workflows for customer management, marketing operations, or bulk data processing.
    */
   'admin.customer-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.customer-index.action.render'>,
@@ -265,9 +222,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the discount index page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the discount index page. Use this to create workflows for discount management, promotional operations, or bulk discount updates.
    */
   'admin.discount-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.discount-index.action.render'>,
@@ -275,9 +230,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the collection details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the collection details page. Use this to create workflows for collection management, product operations, or merchandising tools.
    */
   'admin.collection-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.collection-details.action.render'>,
@@ -285,9 +238,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the collection index page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the collection index page. Use this to create workflows for collection management, bulk operations, or catalog organization.
    */
   'admin.collection-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.collection-index.action.render'>,
@@ -295,9 +246,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the abandoned checkout page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the abandoned checkout details page. Use this to create workflows for cart recovery, customer engagement, or checkout analysis.
    */
   'admin.abandoned-checkout-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.abandoned-checkout-details.action.render'>,
@@ -305,9 +254,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the product variant details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the product variant details page. Use this to create workflows for variant management, inventory operations, or data synchronization.
    */
   'admin.product-variant-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.product-variant-details.action.render'>,
@@ -315,9 +262,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the draft order details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the draft order details page. Use this to create workflows for draft order processing, custom pricing, or order preparation tools.
    */
   'admin.draft-order-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.draft-order-details.action.render'>,
@@ -325,9 +270,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the draft orders page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the draft order index page. Use this to create workflows for draft order management, bulk operations, or order conversion tools.
    */
   'admin.draft-order-index.action.render': RenderExtension<
     ActionExtensionApi<'admin.draft-order-index.action.render'>,
@@ -335,9 +278,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the discount details page. Open this extension from the "More Actions" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **More actions** menu on the discount details page. Use this to create workflows for discount management, promotion analysis, or discount synchronization.
    */
   'admin.discount-details.action.render': RenderExtension<
     ActionExtensionApi<'admin.discount-details.action.render'>,
@@ -345,10 +286,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the order fulfilled card. Open this extension from the "3-dot" menu inside the order fulfilled card.
-   * Note: This extension will only be visible on orders which were fulfilled by your app.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the actions menu inside the order fulfilled card, visible only on orders fulfilled by your app. Use this to create workflows for fulfillment operations, tracking updates, or post-fulfillment actions.
    */
   'admin.order-fulfilled-card.action.render': RenderExtension<
     ActionExtensionApi<'admin.order-fulfilled-card.action.render'>,
@@ -358,9 +296,7 @@ export interface ExtensionTargets {
   // Bulk Actions
 
   /**
-   * Renders an admin action extension 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](/docs/api/admin-extensions/components).
+   * A selection action target that appears in the **More actions** menu on the product index page when multiple products are selected. Use this to create workflows for bulk product operations, batch updates, or mass data processing.
    */
   'admin.product-index.selection-action.render': RenderExtension<
     ActionExtensionApi<'admin.product-index.selection-action.render'>,
@@ -368,9 +304,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension 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](/docs/api/admin-extensions/components).
+   * A selection action target that appears in the **More actions** menu on the order index page when multiple orders are selected. Use this to create workflows for bulk order operations, batch fulfillment, or mass order processing.
    */
   'admin.order-index.selection-action.render': RenderExtension<
     ActionExtensionApi<'admin.order-index.selection-action.render'>,
@@ -378,9 +312,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension 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](/docs/api/admin-extensions/components).
+   * A selection action target that appears in the **More actions** menu on the customer index page when multiple customers are selected. Use this to create workflows for bulk customer operations, mass email campaigns, or batch data updates.
    */
   'admin.customer-index.selection-action.render': RenderExtension<
     ActionExtensionApi<'admin.customer-index.selection-action.render'>,
@@ -388,9 +320,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the draft order page when multiple resources are selected. Open this extension from the "3-dot" menu.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A selection action target that appears in the **More actions** menu on the draft order index page when multiple draft orders are selected. Use this to create workflows for bulk draft order operations, batch conversions, or mass order processing.
    */
   'admin.draft-order-index.selection-action.render': RenderExtension<
     ActionExtensionApi<'admin.draft-order-index.selection-action.render'>,
@@ -398,9 +328,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the product details page when a selling plan group is present. Open this extension from the "Purchase Options card".
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **Purchase Options** card on the product details page when a selling plan group is present. Use this to create workflows for subscription management, selling plan configuration, or purchase option operations.
    */
   'admin.product-purchase-option.action.render': RenderExtension<
     PurchaseOptionsCardConfigurationApi<'admin.product-purchase-option.action.render'>,
@@ -408,9 +336,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin action extension in the product variant details page when a selling plan group is present. Open this extension from the "Purchase Options card".
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * An action target that appears in the **Purchase Options** card on the product variant details page when a selling plan group is present. Use this to create workflows for variant-specific subscription management, selling plan configuration, or purchase option operations.
    */
   'admin.product-variant-purchase-option.action.render': RenderExtension<
     PurchaseOptionsCardConfigurationApi<'admin.product-variant-purchase-option.action.render'>,
@@ -420,9 +346,7 @@ export interface ExtensionTargets {
   // Print actions and bulk print actions
 
   /**
-   * Renders an admin print action extension in the order index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A print action target that appears in the **Print** menu on the order details page. Use this to generate custom documents such as packing slips, shipping labels, or invoices.
    */
   'admin.order-details.print-action.render': RenderExtension<
     PrintActionExtensionApi<'admin.order-details.print-action.render'>,
@@ -430,9 +354,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin print action extension in the product index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A print action target that appears in the **Print** menu on the product details page. Use this to generate custom documents such as product labels, barcode sheets, or specification sheets.
    */
   'admin.product-details.print-action.render': RenderExtension<
     PrintActionExtensionApi<'admin.product-details.print-action.render'>,
@@ -440,9 +362,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin print action extension in the order index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A print action target that appears in the **Print** menu on the order index page when multiple orders are selected. Use this to generate batch documents such as combined packing slips, shipping manifests, or bulk invoices.
    */
   'admin.order-index.selection-print-action.render': RenderExtension<
     PrintActionExtensionApi<'admin.order-index.selection-print-action.render'>,
@@ -450,9 +370,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders an admin print action extension in the product index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A print action target that appears in the **Print** menu on the product index page when multiple products are selected. Use this to generate batch documents such as combined product labels, barcode sheets, or catalog pages.
    */
   'admin.product-index.selection-print-action.render': RenderExtension<
     PrintActionExtensionApi<'admin.product-index.selection-print-action.render'>,
@@ -462,9 +380,7 @@ export interface ExtensionTargets {
   // Other
 
   /**
-   * Renders Product Configuration on product details and product variant details
-   *
-   * See the [tutorial](/docs/apps/selling-strategies/bundles/product-config) for more information
+   * A configuration target that renders product configuration settings for [product bundles](/docs/apps/build/product-merchandising/bundles/product-configuration-extension/add-merchant-config-ui) and customizable products on the product details page. Use this to define bundle component selections, customization options, or product configuration rules.
    */
   'admin.product-details.configuration.render': RenderExtension<
     ProductDetailsConfigurationApi<'admin.product-details.configuration.render'>,
@@ -472,9 +388,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders Product Configuration on product details and product variant details
-   *
-   * See the [tutorial](/docs/apps/selling-strategies/bundles/product-config) for more information
+   * A configuration target that renders product variant configuration settings for [product bundles](/docs/apps/build/product-merchandising/bundles/product-configuration-extension/add-merchant-config-ui) and customizable products on the product variant details page. Use this to define variant-specific bundle components, customization options, or configuration rules.
    */
   'admin.product-variant-details.configuration.render': RenderExtension<
     ProductVariantDetailsConfigurationApi<'admin.product-variant-details.configuration.render'>,
@@ -482,23 +396,23 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Renders Order Routing Rule Configuration on order routing settings.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A function settings target that renders within order routing settings, allowing merchants to configure order routing rule functions.
+   * @private
    */
   'admin.settings.internal-order-routing-rule.render': RenderExtension<
     OrderRoutingRuleApi<'admin.settings.internal-order-routing-rule.render'>,
     FunctionSettingsComponents
   >;
+  /**
+   * A function settings target that renders within order routing settings, allowing merchants to configure order routing rule functions. Use this to build custom configuration interfaces for order routing function parameters.
+   */
   'admin.settings.order-routing-rule.render': RenderExtension<
     OrderRoutingRuleApi<'admin.settings.order-routing-rule.render'>,
     FunctionSettingsComponents
   >;
 
   /**
-   * Renders Validation Settings within a given validation's add and edit views.
-   *
-   * See the [list of available components](/docs/api/admin-extensions/components).
+   * A function settings target that renders within a validation's add and edit views, allowing merchants to configure validation function settings. Use this to build custom configuration interfaces for validation function parameters and rules.
    */
   'admin.settings.validation.render': RenderExtension<
     ValidationSettingsApi<'admin.settings.validation.render'>,
@@ -507,7 +421,7 @@ export interface ExtensionTargets {
 
   // Admin action shouldRender targets
   /**
-   * Controls the render state of an admin action extension in the product details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the product details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on product properties, user permissions, or external data.
    */
   'admin.product-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-details.action.should-render'>,
@@ -515,7 +429,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the catalog details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the catalog details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on catalog properties, user permissions, or external data.
    */
   'admin.catalog-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.catalog-details.action.should-render'>,
@@ -523,7 +437,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the company details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the company details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on company properties, user permissions, or external data.
    */
   'admin.company-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.company-details.action.should-render'>,
@@ -531,7 +445,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the gift card details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the gift card details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on gift card properties, user permissions, or external data.
    */
   'admin.gift-card-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.gift-card-details.action.should-render'>,
@@ -539,7 +453,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the order details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the order details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on order properties, fulfillment status, or external data.
    */
   'admin.order-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-details.action.should-render'>,
@@ -547,7 +461,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the customer details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the customer details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on customer properties, user permissions, or external data.
    */
   'admin.customer-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.customer-details.action.should-render'>,
@@ -555,7 +469,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the customer segment details page. Open this extension from the "Use segment" button.
+   * A non-rendering target that controls whether the customer segment details action appears from the **Use segment** button. Use this to conditionally show or hide your action based on segment properties, user permissions, or external data.
    */
   'admin.customer-segment-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.customer-segment-details.action.should-render'>,
@@ -563,7 +477,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the product index page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the product index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.product-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-index.action.should-render'>,
@@ -571,7 +485,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the order index page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the order index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.order-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-index.action.should-render'>,
@@ -579,7 +493,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the customer index page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the customer index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.customer-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.customer-index.action.should-render'>,
@@ -587,7 +501,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the discount index page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the discount index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.discount-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.discount-index.action.should-render'>,
@@ -595,7 +509,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the collection details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the collection details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on collection properties, user permissions, or external data.
    */
   'admin.collection-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.collection-details.action.should-render'>,
@@ -603,7 +517,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the collection index page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the collection index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.collection-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.collection-index.action.should-render'>,
@@ -611,7 +525,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the abandoned checkout page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the abandoned checkout details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on checkout properties, user permissions, or external data.
    */
   'admin.abandoned-checkout-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.abandoned-checkout-details.action.should-render'>,
@@ -619,7 +533,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the product variant details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the product variant details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on variant properties, user permissions, or external data.
    */
   'admin.product-variant-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-variant-details.action.should-render'>,
@@ -627,7 +541,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the draft order details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the draft order details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on draft order properties, user permissions, or external data.
    */
   'admin.draft-order-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.draft-order-details.action.should-render'>,
@@ -635,7 +549,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the draft orders page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the draft order index action appears in the **More actions** menu. Use this to conditionally show or hide your action based on user permissions, store configuration, or external data.
    */
   'admin.draft-order-index.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.draft-order-index.action.should-render'>,
@@ -643,7 +557,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the discount details page. Open this extension from the "More Actions" menu.
+   * A non-rendering target that controls whether the discount details action appears in the **More actions** menu. Use this to conditionally show or hide your action based on discount properties, user permissions, or external data.
    */
   'admin.discount-details.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.discount-details.action.should-render'>,
@@ -651,8 +565,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the order fulfilled card. Open this extension from the "3-dot" menu inside the order fulfilled card.
-   * Note: This extension will only be visible on orders which were fulfilled by your app.
+   * A non-rendering target that controls whether the order fulfilled card action appears in the actions menu. Use this to conditionally show or hide your action based on fulfillment properties, user permissions, or external data.
    */
   'admin.order-fulfilled-card.action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-fulfilled-card.action.should-render'>,
@@ -662,7 +575,7 @@ export interface ExtensionTargets {
   // Admin bulk action shouldRender targets
 
   /**
-   * Controls the render state of an admin action extension 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.
+   * A non-rendering target that controls whether the product index selection action appears in the **More actions** menu. Use this to conditionally show or hide your bulk action based on selection criteria, user permissions, or external data.
    */
   'admin.product-index.selection-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-index.selection-action.should-render'>,
@@ -670,7 +583,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension 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.
+   * A non-rendering target that controls whether the order index selection action appears in the **More actions** menu. Use this to conditionally show or hide your bulk action based on selection criteria, user permissions, or external data.
    */
   'admin.order-index.selection-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-index.selection-action.should-render'>,
@@ -678,7 +591,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension 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.
+   * A non-rendering target that controls whether the customer index selection action appears in the **More actions** menu. Use this to conditionally show or hide your bulk action based on selection criteria, user permissions, or external data.
    */
   'admin.customer-index.selection-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.customer-index.selection-action.should-render'>,
@@ -686,7 +599,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin action extension in the draft order page when multiple resources are selected. Open this extension from the "3-dot" menu.
+   * A non-rendering target that controls whether the draft order index selection action appears in the **More actions** menu. Use this to conditionally show or hide your bulk action based on selection criteria, user permissions, or external data.
    */
   'admin.draft-order-index.selection-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.draft-order-index.selection-action.should-render'>,
@@ -696,7 +609,7 @@ export interface ExtensionTargets {
   // Admin print action and bulk print action shouldRender targets
 
   /**
-   * Controls the render state of an admin print action extension in the order index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
+   * A non-rendering target that controls whether the order details print action appears in the **Print** menu. Use this to conditionally show or hide your print action based on order properties, user permissions, or external data.
    */
   'admin.order-details.print-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-details.print-action.should-render'>,
@@ -704,7 +617,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin print action extension in the product index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
+   * A non-rendering target that controls whether the product details print action appears in the **Print** menu. Use this to conditionally show or hide your print action based on product properties, user permissions, or external data.
    */
   'admin.product-details.print-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-details.print-action.should-render'>,
@@ -712,7 +625,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin print action extension in the order index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
+   * A non-rendering target that controls whether the order index selection print action appears in the **Print** menu. Use this to conditionally show or hide your bulk print action based on selection criteria, user permissions, or external data.
    */
   'admin.order-index.selection-print-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.order-index.selection-print-action.should-render'>,
@@ -720,7 +633,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Controls the render state of an admin print action extension in the product index page when multiple resources are selected. Open this extension from the "Print" menu of the resource list. The resource ids are available to this extension at runtime.
+   * A non-rendering target that controls whether the product index selection print action appears in the **Print** menu. Use this to conditionally show or hide your bulk print action based on selection criteria, user permissions, or external data.
    */
   'admin.product-index.selection-print-action.should-render': RunnableExtension<
     ShouldRenderApi<'admin.product-index.selection-print-action.should-render'>,
@@ -728,7 +641,7 @@ export interface ExtensionTargets {
   >;
 
   /**
-   * Provides tools data for the admin tools functionality.
+   * A runnable target that enables your app to expose data to [Sidekick](/docs/apps/build/sidekick/build-app-data). Use this target to register tools that Sidekick can invoke to search your app's data and answer merchant questions.
    */
   'admin.app.tools.data': RunnableExtension<
     StandardApi<'admin.app.tools.data'>,
@@ -736,4 +649,7 @@ export interface ExtensionTargets {
   >;
 }
 
+/**
+ * A string literal union of all valid extension target identifiers. Use this type to specify where your admin UI extension should render, such as `admin.product-details.block.render` for a block on product details pages or `admin.order-details.action.render` for an action on order details pages. The target determines the extension's location, available APIs, and UI components.
+ */
 export type ExtensionTarget = keyof ExtensionTargets;