Customer segment template extension issue with dev preview

Extensions
1

Question about admin.customers.segmentation-templates.data developer preview

We’re building a new extension (Customer Segment Template extension).

We’re using the admin.customers.segmentation-templates.data and admin.customer-segment-details.action.render extension targets, but we’re hitting this error when running shopify app dev:

“Segmentation template ui is in developer preview and cannot be deployed to production stores.”

We’re testing on a development store, not production. We couldn’t find where to enable the developer preview for this feature in the Partners dashboard.

Has anyone successfully enabled this preview? Is there a specific opt-in step in the Partners portal, or does it need to be requested directly from Shopify? Any pointers appreciated!

2

@Ishaan_Shettigar Can you try using admin.customers.segmentation-templates.render with API version 2025-07? Make sure your package.json also has:

 "dependencies": {
    "@shopify/ui-extensions": "2025.7.x"
  }

Let me know if this works for you!

1 Like
3

Thank you so much Paige! It worked

4

Hey @Paige-Shopify ,
Although it is running now. For some reason my test extension isn’t shown in the UI.
Below is a screenshot of what I see.

image
image2724×966 170 KB

Here is the main function

export default async function extension() {
  const {i18n} = shopify;

  const query = 'first_order_date IS NULL';
  const queryToInsert = 'first_order_date IS NULL';

  return [{
    title: i18n.translate('title'),
    description: i18n.translate('description'),
    createdOn: new Date('2023-08-15').toISOString(),
    query,
    queryToInsert
  }];
}

I did verify that query in the Segment Editor, it is valid. The translations file also seem to be correct, Am I doing something wrong here?

5

For the render target you will want to render React components. Here’s the example from the docs:

The templates should appear like this in the admin:

15-54-49gad-tnt4w
15-54-49gad-tnt4w1768×1002 82.5 KB

6

Thank you Paige, It worked! :partying_face: . We will be releasing our extension this week. Thank you so much for your help!