Getting Ready for Shopify Admin’s New Look: A Developer‑Focused Guide

Shopify’s admin UI is getting a visual overhaul starting September 15, 2026. Learn what changes look like, which apps are affected, and how to prepare your embedded app for Polaris 2.0 with actionable steps and code examples.

Getting Ready for Shopify Admin’s New Look: A Developer‑Focused Guide
6 sections

Shopify is rolling out a fresh visual design for the admin interface beginning September 15, 2026. The new look brings updated colors, typography, spacing, and iconography, plus a re‑imagined side navigation that collapses for more screen real estate. While the aesthetic changes are significant, the underlying functionality stays the same – but the update does have implications for developers who build admin‑embedded experiences. This post breaks down exactly what’s changing, who is impacted, and the concrete steps you should take right now to stay ahead of the curve.

What Merchants Will See

When the rollout reaches a merchant’s store, they’ll notice a cleaner header, new side‑navigation placement for search, notifications, and the store picker, and a floating “Sidekick” chat that lives at the bottom of the screen instead of a side panel. Spacing between elements is tighter, icons have been refreshed, and the overall frame feels more modern. All of these visual tweaks are applied automatically for extensions that rely on Shopify’s built‑in UI components.

Impact on Different Types of Apps

Admin UI extensions & App Home UI extensions – These extensions pull styling directly from Shopify’s design system. As the new admin rolls out, they inherit the updated look without any code changes from you. Functionality remains identical, so no immediate action is required.

Embedded App Home apps that use Polaris Web Components 1.x – If your app renders a custom interface inside the App Home and you’re currently on Polaris 1.0 (or the 1.1 release candidate), your UI will stay on the old design until you decide to upgrade. This gives you full control over when you adopt the new aesthetics.

Embedded App Home apps that don’t use Polaris – Apps built with custom HTML/CSS or third‑party component libraries won’t automatically pick up the new admin styles. To align with the refreshed admin, you’ll need to migrate to Polaris Web Components first, then upgrade to the upcoming Polaris 2.0 release candidate.

Preparing for Polaris 2.0

Polaris 2.0 is the next major version of Shopify’s design system and will ship styles that match the new admin UI. The upgrade follows a semantic‑versioning model on the Polaris CDN, meaning you’ll explicitly opt‑in to the major version change. Until the Polaris 2.0 release candidate lands, you can start preparing now by migrating any legacy UI to the current Polaris Web Components (v1.x). Once you’re on the Web Components stack, moving to 2.0 will be a matter of updating the CDN version string.

### Step‑by‑step migration checklist

  • Add the Polaris Web Components package – If you’re not already using it, install the npm package:
  • bash

    npm install @shopify/polaris@^1.0

  • Replace custom UI with Polaris components – Swap out hand‑crafted buttons, tables, and forms for their Polaris equivalents. Most components accept similar props, so the refactor is straightforward.
  • Update the CDN reference – In your index.html (or equivalent) point to the Polaris 1.1 release candidate:
  • html

    <link rel="stylesheet" href="https://unpkg.com/@shopify/polaris@1.1.0/dist/polaris.css" />

  • Test in the refreshed admin – Enable the “Shopify admin preview” flag in your partner dashboard to see how your app looks under the new UI while the rollout is still in progress.
  • Plan the Polaris 2.0 switch – When Shopify announces the 2.0 release candidate, simply change the version in the CDN URL (e.g., @2.0.0) and run your UI regression tests. Because the major version bump is explicit, merchants will only see the new styling after you publish the update.
  • Timeline and Rollout Details

    The rollout starts on September 15, 2026 and follows a progressive, shop‑by‑shop schedule. During the rollout, a single merchant might see either the old or the new admin depending on where they are in the deployment wave. This means that while you’re testing, you could encounter both versions in the wild. Keep an eye on the “Admin preview” toggle in your partner dashboard—it lets you force the new UI for any shop you own, giving you a reliable testing environment.

    Action Checklist for Developers

  • If you only use Admin UI or App Home UI extensions – No code changes required. Just monitor the rollout.
  • If your app embeds a custom App Home UI – Decide whether to stay on Polaris 1.x or migrate now.
  • Migrate to Polaris Web Components – Follow the steps above to future‑proof your UI.
  • Set up a test shop with the admin preview flag – Validate your app’s appearance against the new design.
  • Watch for the Polaris 2.0 release candidate announcement – When it arrives, update the CDN version and run regression tests.
  • Communicate with merchants – Let them know that any visual changes will happen only after you publish a new version of your app.
  • Conclusion & Next Steps

    Shopify’s refreshed admin UI is an opportunity to modernize the look and feel of your embedded experiences. By understanding which parts of your app are automatically updated and which require a deliberate migration to Polaris 2.0, you can ensure a seamless transition for your merchants. Start the migration to Polaris Web Components today, set up the admin preview flag, and keep an eye on Shopify’s developer announcements for the 2.0 release candidate. Your proactive preparation will keep your app looking polished and fully functional when the new admin reaches every shop.

    Ready to future‑proof your Shopify app? Dive into the official App Home documentation, grab the Polaris 1.1 release candidate, and begin the migration now. If you hit any snags, drop a comment below or join the #shopify‑dev community on Discord—your fellow developers are happy to help!

    Tags
    Sources

    Related Articles

    Mark Unreceived Stock with the New CANCELED Receive Action in Shopify’s Inventory Shipments API
    Platform Updates

    Mark Unreceived Stock with the New CANCELED Receive Action in Shopify’s Inventory Shipments API

    Shopify’s 2026-10 API adds a CANCELED receive action for inventory shipments, letting apps record units that will never arrive. Learn what changed, who it affects, and how to implement the new fields, enum, and webhook updates.

    September 17, 20264 min
    POS UI Extensions Lose session.currentSession.staffMemberId – What Developers Need to Update for 2026‑10
    Platform Updates

    POS UI Extensions Lose session.currentSession.staffMemberId – What Developers Need to Update for 2026‑10

    The static session.currentSession.staffMemberId field is removed in API version 2026‑10. Learn how to switch to the new session.staffMember signal, update your code, and keep POS extensions running smoothly.

    September 17, 20263 min
    Inside Shopify’s New Pricing Audit Trail for Contextual Variant Prices
    Platform Updates

    Inside Shopify’s New Pricing Audit Trail for Contextual Variant Prices

    Shopify’s 2026-10 API adds a pricing audit trail to product variant contextual pricing, letting apps see exactly how prices are calculated. Learn what changed, who’s affected, and how to query the new field.

    September 17, 20264 min
    Mastering Shopify Event Updates: New Payload Structure, Triggers, and Headers
    Platform Updates

    Mastering Shopify Event Updates: New Payload Structure, Triggers, and Headers

    Shopify’s latest event update reshapes payloads, refines trigger syntax, and removes two delivery headers. Learn what changed, who’s affected, and how to migrate your webhook subscriptions with clear code examples.

    September 16, 20264 min