[Docs] Empty documentation for admin extension UI targets

Community Feedback
1

Hi there,

Just letting y’all know that the Extension Targets reference page for Admin UI extensions is currently missing for all API versions:

I found this page through the link on the Admin Extensions Customer Details Target accordian:

I was curious about the admin.customer-details.action.should-render target specifically, but now I’m not sure if this target actually exists and this is a preview of a target that’s in the works.

Thanks!

2

Hey - it looks to be available on 2024-04 and previous but not any more recent than that:

27-54-bcyse-dscag
27-54-bcyse-dscag1177×872 95.9 KB

3

Hey @Dylan :waving_hand:, that’s definitely a little odd. That other pages does seem to be the more up to date documentation and references the same data that was/is in the older extensions target reference page from what I can tell.

I’ll do a bit more digging into this and loop back with you once I’ve got some more information!

5

No worries @Alan_G and @Liam-Shopify - just thought to let y’all know

6

Prior to the 2025-10 version (current release candidate), it was necessary to include the target in both the extension toml file and in the shouldRender file.

2025-04: The *.-should-render target is necessary

# shopify.extension.toml
api_version = "2025-04"

[[extensions]]
name = "t:name"
handle = "2025-04-conditional-action"
type = "ui_extension"

[[extensions.targeting]]
# The target used here must match the target used in the module file (./src/ActionExtension.tsx)
target = "admin.customer-details.action.render" # ----- 👈 -----
module = "./src/ActionExtension.tsx"

# This is the relative path to the module that contains the logic to determine if the action trigger should be visible.
[extensions.targeting.should_render]
module = "./src/condition/shouldRender.ts"

// shouldRender.ts
// The target used here must match the target used in the extension's toml file (./shopify.extension.toml),
// except for the "should-render" suffix
const TARGET = "admin.customer-details.action.should-render"; # ----- 👈 -----

// The second argument to the render callback provides access to the resource ID.
export default shopify.extend(TARGET, async ({ data }) => {
  return { display: Math.random() > 0.5 };
});

2025-10: The *.-should-render target is no longer necessary

However, starting in 2025-10 (current release candidate), the admin.customer-details.action.should-render target is no longer necessary because you only have to set the target in the toml file.

# shopify.extension.toml
api_version = "2025-10"
[[extensions]]
name = "t:name"
handle = "2025-10-conditional-action"
type = "ui_extension"

# Only 1 target can be specified for each Admin action condition extension
[[extensions.targeting]]
module = "./src/ActionExtension.jsx"
target = "admin.customer-details.action.render" # ----- 👈 -----

# This is the relative path to the module that contains the logic to determine if the action trigger should be visible.
[extensions.targeting.should_render]
module = "./src/condition/shouldRender.js"

// shouldRender.js
export default async function extension() {
  return { display: Math.random() > 0.5 };
}

References