Removing outdated Polaris reference docs
Shopify is removing Polaris reference docs older than 12 months starting April 2026, keeping only the last four stable versions live on Shopify.dev. Affects developers maintaining Admin, Checkout, Customer Account, and POS UI extensions.
Agencies and brands with custom Shopify extensions built on older API versions risk broken deployments with no documentation fallback. Audit your Shopify CLI extension targets now — anything older than 12 months won't deploy anyway.
Platform consolidation in action: Shopify is tightening its developer ecosystem, forcing agencies and brands to stay current or lose deployment capability -- raising the maintenance cost of custom Shopify builds.
Check your Shopify CLI extension config files -- if targeting an API version older than 12 months, update to a supported version before your next deploy or it will fail.
In the next 30 days, audit all client Shopify storefronts with custom extensions and flag any using pre-2025 Polaris versions for migration.
Bottom Line
Outdated Shopify extension docs gone -- broken deploys likely for unmaintained storefronts.
Source Lens
Technical Platform Update
Official but usually technical. Useful only when the change affects merchant-facing operations.
Impact Level
medium
Outdated Shopify extension docs gone -- broken deploys likely for unmaintained storefronts.
Key Stat / Trigger
12-month minimum support window for each stable Polaris version
Focus on the operational implication, not just the headline.
Full Coverage
Back to Developer changelog April 1, 2026 Tags: Admin Extensions Checkout UI Customer Accounts POS Extensions 2026-04 Removing outdated Polaris reference docs Ask assistant Polaris reference docs now follow the same versioning policy as Shopify's GraphQL APIs: Each stable version is supported for a minimum of 12 months.
Older versions continue to work, they just won’t have dedicated docs on Shopify. dev. Shopify CLI already prevents deploys targeting API versions older than 12 months, so we recommend keeping your extensions on a supported version.
Starting with the 2026-04 release, we'll only publish docs for the last four stable versions of these reference docs: Admin UI extensions Checkout UI extensions Customer account UI extensions POS UI extensions Was this section helpful? Yes No
Original Source
This briefing is based on reporting from Shopify Developer Changelog. Use the original post for full primary-source context.
Style
Audience