Merge pull request #3569 from Shopify/dc-64kb-limit

Add 64kb limit notes

Author: davejcameron

packages/ui-extensions/docs/surfaces/admin/staticPages/admin-extensions.ext.doc.ts

@@ -200,6 +200,24 @@ If your app is using ESLint, update your configuration to include the new global
         },
       ],
     },
+    {
+      type: 'Generic',
+      anchorLink: 'limitations',
+      title: 'Limitations',
+      sectionContent: `
+As of \`2025-10\`, UI extensions have the following limitations:
+- **File size limit**: Extensions are limited to a maximum of 64 KB when deployed. This limit helps ensure fast loading times and optimal performance.
+`,
+      sectionNotice: [
+        {
+          title: 'Note',
+          sectionContent: `
+The 64 KB limit applies to the compiled extension bundle size upon deployment.
+`,
+          type: 'info',
+        },
+      ],
+    },
     {
       type: 'Generic',
       title: 'Deploying',

packages/ui-extensions/docs/surfaces/checkout/staticPages/overview.doc.ts

@@ -223,6 +223,24 @@ Checkout UI extensions don’t have access to the real checkout DOM and can’t
         },
       ],
     },
+    {
+      type: 'Generic',
+      anchorLink: 'limitations',
+      title: 'Limitations',
+      sectionContent: `
+As of \`2025-10\`, UI extensions have the following limitations:
+- **File size limit**: Extensions are limited to a maximum of 64 KB when deployed. This limit helps ensure fast loading times and optimal performance for buyers during checkout.
+`,
+      sectionNotice: [
+        {
+          title: 'Note',
+          sectionContent: `
+The 64 KB limit applies to the compiled extension bundle size upon deployment.
+`,
+          type: 'info',
+        },
+      ],
+    },
     {
       type: 'Generic',
       anchorLink: 'troubleshooting',

packages/ui-extensions/docs/surfaces/checkout/staticPages/upgrading-to-2025-10.doc.ts

@@ -28,6 +28,22 @@ This guide describes how to upgrade your checkout UI extension to API version \`
         ],
       },
     },
+    {
+      type: 'Generic',
+      anchorLink: 'file-size-limit',
+      title: 'File size limit',
+      sectionContent:
+        'As of `2025-10`, UI extensions are subject to a **64 KB file size limit** upon deployment. This limit applies to the compiled extension bundle and is enforced to ensure fast loading times and optimal performance for buyers during checkout.',
+      sectionNotice: [
+        {
+          title: 'Important',
+          sectionContent: `
+If your extension exceeds 64 KB, deployment will fail.
+`,
+          type: 'warning',
+        },
+      ],
+    },
     {
       type: 'GenericAccordion',
       anchorLink: 'adjust-dependencies',

packages/ui-extensions/docs/surfaces/customer-account/staticPages/overview.doc.ts

@@ -281,6 +281,24 @@ Customer account UI extensions don’t have access to the real customer account
         },
       ],
     },
+    {
+      type: 'Generic',
+      anchorLink: 'limitations',
+      title: 'Limitations',
+      sectionContent: `
+As of \`2025-10\`, UI extensions have the following limitations:
+- **File size limit**: Extensions are limited to a maximum of 64 KB when deployed. This limit helps ensure fast loading times and optimal performance for customers.
+`,
+      sectionNotice: [
+        {
+          title: 'Note',
+          sectionContent: `
+The 64 KB limit applies to the compiled extension bundle size upon deployment.
+`,
+          type: 'info',
+        },
+      ],
+    },
     {
       type: 'Generic',
       anchorLink: 'troubleshooting',

packages/ui-extensions/docs/surfaces/customer-account/staticPages/upgrading-to-2025-10.doc.ts

@@ -26,6 +26,22 @@ const data: LandingTemplateSchema = {
         ],
       },
     },
+    {
+      type: 'Generic',
+      anchorLink: 'file-size-limit',
+      title: 'File size limit',
+      sectionContent:
+        'As of `2025-10`, UI extensions are subject to a **64 KB file size limit** upon deployment. This limit applies to the compiled extension bundle and is enforced to ensure fast loading times and optimal performance for customers.',
+      sectionNotice: [
+        {
+          title: 'Important',
+          sectionContent: `
+If your extension exceeds 64 KB, deployment will fail.
+`,
+          type: 'warning',
+        },
+      ],
+    },
     {
       type: 'GenericAccordion',
       anchorLink: 'adjust-dependencies',

packages/ui-extensions/docs/surfaces/point-of-sale/staticPages/pos-overview.doc.ts

@@ -109,6 +109,24 @@ You can track new releases and update your extensions by referencing the [develo
         },
       ],
     },
+    {
+      type: 'Generic',
+      anchorLink: 'limitations',
+      title: 'Limitations',
+      sectionContent: `
+As of \`2025-10\`, UI extensions have the following limitations:
+- **File size limit**: Extensions are limited to a maximum of 64 KB when deployed. This limit helps ensure fast loading times and optimal performance for POS devices.
+`,
+      sectionNotice: [
+        {
+          title: 'Note',
+          sectionContent: `
+The 64 KB limit applies to the compiled extension bundle size upon deployment.
+`,
+          type: 'info',
+        },
+      ],
+    },
   ],
 };