From 45fc104b3cad1fa36a1a1f7c6f430ff413b9e741 Mon Sep 17 00:00:00 2001
From: Victor Chu <victor.chu@shopify.com>
Date: Tue, 11 Mar 2025 11:27:22 -0700
Subject: [PATCH] Update POS migration docs
---
.../staticPages/examples/migrating/setup.npm.bash | 4 ++--
.../staticPages/examples/migrating/setup.yarn.bash | 4 ++--
.../staticPages/examples/migrating/shopify.extension.toml | 2 +-
.../surfaces/point-of-sale/staticPages/pages/migrating.doc.ts | 4 +---
.../surfaces/point-of-sale/staticPages/pages/versions.doc.ts | 2 +-
5 files changed, 7 insertions(+), 9 deletions(-)
diff --git a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.npm.bash b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.npm.bash
index ead645420d..70cf6d250b 100644
--- a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.npm.bash
+++ b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.npm.bash
@@ -9,5 +9,5 @@ npm update react@^18.2.0
npm update @types/react@^18.2.0
# 4. Install the new packages
-npm install @shopify/ui-extensions@2024.4
-npm install @shopify/ui-extensions-react@2024.4
+npm install @shopify/ui-extensions@2025.4
+npm install @shopify/ui-extensions-react@2025.4
diff --git a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.yarn.bash b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.yarn.bash
index 8849cb6268..96d32b3b72 100644
--- a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.yarn.bash
+++ b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/setup.yarn.bash
@@ -9,5 +9,5 @@ yarn upgrade react@^18.2.0
yarn upgrade @types/react@^18.2.0
# 4. Install the new packages
-yarn add @shopify/ui-extensions@2024.4
-yarn add @shopify/ui-extensions-react@2024.4
+yarn add @shopify/ui-extensions@2025.4
+yarn add @shopify/ui-extensions-react@2025.4
diff --git a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/shopify.extension.toml b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/shopify.extension.toml
index 92ba5c9aea..4fa9c9c2f7 100644
--- a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/shopify.extension.toml
+++ b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/examples/migrating/shopify.extension.toml
@@ -1,4 +1,4 @@
-api_version = "2024-04"
+api_version = "2025-04"
[[extensions]]
type = "ui_extension"
diff --git a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/migrating.doc.ts b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/migrating.doc.ts
index 2efb996166..2ed98a563c 100644
--- a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/migrating.doc.ts
+++ b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/migrating.doc.ts
@@ -30,8 +30,6 @@ const data: LandingTemplateSchema = {
POS UI Extensions are moving to the newer \`@shopify/ui-extensions\` package, shared with [Checkout UI Extensions](https://shopify.dev/docs/api/checkout-ui-extensions) and [Admin UI Extensions](https://shopify.dev/docs/api/admin-extensions). This will allow your extensions to use the same package regardless of the surface they extend, and for a single extension to implement multiple targets across different surfaces of Shopify more easily.
\`@shopify/retail-ui-extensions\` and \`@shopify/retail-ui-extensions-react\` are deprecated. They are now maintained as part of \`@shopify/ui-extensions\` and \`@shopify/ui-extensions-react\`. This guide explains how to migrate from the old packages to the new ones.
-
-Aside from these migration steps, \`@shopify/ui-extensions@2024.4\` is backwards compatible with \`@shopify/retail-ui-extensions@1.7.0\`.
`,
},
{
@@ -89,7 +87,7 @@ Migrate your \`shopify.extension.toml\` file to reflect the [new syntax](https:/
- Specify which \`api_version\` you are using at the top of the file (above \`[[extensions]]\`). This will let POS know which version of the \`ui-extensions\` package you're using.
> Note:
-> \`api_version\` needs to be declared in a \`yyyy-mm\` format. If you are using \`@shopify/ui-extensions\` version \`2024.4\` for example, you must declare your \`api_version\` as 2024-04. The patch is irrelevant to \`api_version\`.
+> \`api_version\` needs to be declared in a \`yyyy-mm\` format. If you are using \`@shopify/ui-extensions\` version \`2025.4\` for example, you must declare your \`api_version\` as 2025-04. The patch is irrelevant to \`api_version\`.
- Declare each extension target and file path in \`shopify.extension.toml\`
`,
diff --git a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/versions.doc.ts b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/versions.doc.ts
index ec93be6119..390a1e1f13 100644
--- a/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/versions.doc.ts
+++ b/packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pages/versions.doc.ts
@@ -42,7 +42,7 @@ Refer to the [migration guide](/docs/api/pos-ui-extensions/migrating) for more i
anchorLink: '202504',
title: '2025.04',
sectionContent: `
-- Added in POS version: N/A
+- Added in POS version: 9.31
- Removed in POS version: N/A
- Release day: N/A