Polaris 2.0 Shopify: nuovo Admin e migrazione app

Interfaccia di una app Shopify che passa dal vecchio stile Admin a un layout moderno compatibile con Polaris 2.0

Polaris 2.0 è disponibile come release candidate per le App Home embedded, mentre il nuovo design dell'Admin Shopify è in rollout progressivo dal 15 settembre 2026. La conseguenza pratica per chi sviluppa app è semplice: il passaggio non è automatico per le interfacce embedded, e al 28 settembre 2026 la versione stabile consigliata per la produzione resta Polaris 1.1.

Il 24 settembre Shopify ha pubblicato la release candidate di Polaris 2.0. Il nuovo bundle contiene gli stili necessari per adattare i Polaris Web Components al design dell'Admin disponibile nello store. Negli store già migrati i componenti adottano nuovi colori, tipografia, spaziature e icone; negli store ancora sul design precedente mantengono l'aspetto compatibile con Polaris 1.

Chi deve aggiornare e chi no

Admin UI extensions e App Home UI extensions ricevono automaticamente lo stile dell'Admin disponibile per il merchant. La superficie viene renderizzata da Shopify, quindi non serve riscrivere l'estensione solo per ottenere il nuovo look.

Per una App Home embedded che renderizza la propria UI, invece, l'adozione è esplicita. Se l'app continua a usare Polaris 1 o il vecchio endpoint non versionato, non passa da sola alla 2.0. Se l'interfaccia usa ancora Polaris React o una UI custom, prima bisogna valutare la migrazione verso i Web Components supportati.

Release candidate non significa stable

La documentazione Shopify continua a raccomandare il canale stabile di Polaris 1 per la produzione. Polaris 2.0 è ancora una release candidate e può cambiare durante il periodo di test. Per questo la userei ora per preparare e validare la migrazione, non per spostare automaticamente una produzione stabile.

Quando Shopify promuoverà la 2.0 a stable, verrà pubblicato il relativo canale stabile. Anche quel passaggio resterà una scelta esplicita dell'app.

Se usi Polaris React, non è un semplice cambio di versione

Le app che usano già Polaris Web Components possono iniziare il test aggiornando il bundle e verificando l'interfaccia. Le app ancora basate su Polaris React richiedono invece una migrazione più attenta: Shopify sta pubblicando guide componente per componente e non tutte le primitive hanno un equivalente uno-a-uno.

Il criterio corretto non è cercare una copia pixel-per-pixel. Bisogna preservare comportamento e accessibilità: focus da tastiera, stati di errore, selezione, navigazione, responsive e flussi di salvataggio devono continuare a funzionare dopo il cambio di componenti.

La checklist di test per un'App Home embedded

Provare sia il nuovo Admin sia quello precedente. Durante il rollout la stessa app può essere vista in entrambi i contesti.
Controllare Page, Section e azioni principali. Sono gli elementi che incidono di più sulla coerenza visiva.
Rivedere il CSS custom. Stili che replicano manualmente colori, ombre o spaziature del vecchio Polaris possono diventare incoerenti.
Verificare contenuti sticky o fixed. Sidekick ora usa una chat flottante nella parte bassa dell'Admin e può sovrapporsi a controlli fissati vicino al bordo inferiore.
Testare responsive, zoom e tastiera. Layout stretti, contenuti tradotti lunghi e focus visibile sono regressioni facili da perdere.
Chiudere con test funzionali. Form, filtri, modali, navigazione e salvataggi devono produrre gli stessi risultati di prima.

Shopify mette a disposizione anche una variabile CSS di safe area per evitare che contenuti fissi nella parte bassa vengano coperti dalla nuova barra flottante di Sidekick.

Built for Shopify: la data da tenere a mente

Per le app che partecipano a Built for Shopify, Shopify indica il 1 maggio 2027 come termine per aggiornare l'App Home embedded in modo che rispecchi lo stile dell'Admin. Non è un obbligo a portare oggi una release candidate in produzione: è una finestra per preparare, testare e poi adottare la versione stabile.

Tre errori che eviterei

Primo: trattare la release candidate come se fosse già stable. Secondo: ridisegnare manualmente l'app per imitare l'Admin invece di usare le primitive supportate. Terzo: controllare solo l'aspetto e ignorare accessibilità e comportamento.

Nel lavoro sulle app Shopify tratterei Polaris 2.0 come una migrazione con un gate separato dalla release funzionale: ambiente di test, migrazione incrementale dove serve, regression dei flussi merchant e solo dopo valutazione del passaggio alla stable.

È lo stesso principio che applico al monitoraggio tecnico: una modifica non è conclusa perché il codice è cambiato, ma quando il runtime reale conferma che il comportamento atteso funziona. Ho approfondito questo metodo nella guida al Shopify Dev Dashboard. Per il lavoro con coding agent e documentazione aggiornata, vedi anche Shopify AI Toolkit e la skill unica shopify.