Web Install API: cosa cambia per le web app
La Web Install API permette a un sito di chiedere al browser di installare un'applicazione web, senza passare da un app store. Funziona in due modi: con l'elemento HTML <install>, che genera un pulsante gestito dal browser, o con il metodo navigator.install(), che consente un pulsante personalizzato e l'installazione di app anche da altri domini. Il browser mostra sempre una finestra di conferma: nessun sito installa nulla in silenzio. Chrome la supporta dalla versione 158, Edge la sperimenta dalla 143, Firefox e Safari no.
Aggiornato a novembre 2026. Dati verificati sulla documentazione per sviluppatori di Chrome, sull'explainer del WICG e sulle posizioni standard di WebKit e Microsoft il 21 novembre 2026.
- Chrome ha reso disponibile la Web Install API nella versione stabile 158, pubblicata a metà novembre 2026, dopo mesi di disponibilità solo tramite flag sperimentali.
- Microsoft Edge ha avviato la sperimentazione con l'origin trial nella versione 143, nel novembre 2025, e il supporto è proseguito nelle versioni successive.
- WebKit, il motore di Safari, ha espresso una posizione contraria allo standard; Firefox non ha ancora una posizione ufficiale.
Installare una web app oggi richiede una piccola caccia al tesoro: l'icona nella barra degli indirizzi, la voce nascosta nel menu del browser, il banner che gli sviluppatori aggiungono per spiegare dove cliccare. La Web Install API nasce per eliminare questo passaggio. Il sito chiede, il browser conferma, l'app si installa. Dietro c'è uno standard del WICG, il gruppo che sperimenta le nuove funzioni del web, e un cambio di prospettiva: la pagina che stai visitando diventa il punto di distribuzione di se stessa.
Cos'è la Web Install API e cosa risolve
La Web Install API è un'interfaccia del browser che permette a una pagina web di richiedere l'installazione di un'applicazione web, con il consenso esplicito dell'utente. Non è un sostituto degli app store né un modo per aggirare i permessi: è un canale standardizzato per un'azione che oggi avviene in modo confuso e disomogeneo tra browser. Il problema che risolve è di scoperta. Molte persone non sanno che un sito può essere installato come app, e chi lo sa spesso non ricorda dove si trova il comando. La conseguenza è che le applicazioni web progressive, le cosiddette PWA, vengono usate come semplici siti anche quando potrebbero girare in una finestra dedicata, con icona sul desktop e avvio più rapido. La novità non è tecnica ma di percorso: l'installazione diventa un'azione esplicita, proposta nel contesto in cui l'utente sta già usando il servizio. Per chi costruisce siti e applicazioni, la guida su come creare un sito web con le guide di Gedix copre le basi su cui questa API si innesta.
Come funziona: le due strade dell'API
Lo standard espone due superfici distinte, pensate per esigenze diverse. La prima è dichiarativa e non richiede JavaScript; la seconda è programmatica e dà il controllo completo. In entrambi i casi il browser mantiene l'ultima parola: senza una conferma dell'utente, l'installazione non avviene. Serve inoltre che il sito sia servito in HTTPS e che l'app abbia un manifest valido, perché il browser deve sapere cosa sta installando prima di mostrare la richiesta. Chi ospita il sito su un servizio con certificato incluso e supporto ai file statici parte avvantaggiato: la guida sui migliori hosting WordPress e cloud spiega quali caratteristiche verificare.
L'elemento install: il pulsante gestito dal browser
L'elemento <install> è la via più semplice. Si inserisce nel markup della pagina e il browser genera un pulsante con il proprio aspetto, le proprie etichette e le proprie traduzioni. Non serve scrivere JavaScript e l'esperienza è uniforme su tutti i siti che lo adottano, il che riduce il rischio di interfacce ambigue. Il rovescio della medaglia è che l'aspetto non è personalizzabile e il numero di questi elementi per pagina è limitato dalle misure anti-abuso dei browser, per evitare pagine cosparse di richieste di installazione.
Il metodo navigator.install() per il controllo totale
Il metodo navigator.install() è la strada programmatica. Si chiama da JavaScript, restituisce una promessa e permette di costruire un pulsante su misura, coerente con il design del sito. La differenza più interessante è la possibilità di installare un'applicazione pubblicata su un dominio diverso da quello della pagina: un catalogo può quindi proporre l'installazione di più web app, anche di terze parti. In questo caso il browser aggiunge un passaggio di consenso ulteriore, perché la richiesta cross-origin è più delicata di quella same-origin. Sui browser che non supportano l'API, la chiamata viene semplicemente ignorata e resta il flusso classico di installazione dal menu del browser.
Il manifest PWA: cosa deve contenere
Un manifest PWA è un file JSON che descrive l'applicazione web e che il browser legge prima di installarla. Deve contenere almeno il nome e il nome breve, le icone nelle dimensioni richieste, il colore del tema e di sfondo, la modalità di visualizzazione e un identificativo stabile. Quest'ultimo è il punto più delicato: se l'identificativo cambia, il browser considera l'app come una nuova installazione e l'utente si ritrova con due icone identiche. Per questo va scelto una volta e mantenuto nel tempo, anche quando cambiano nome commerciale o dominio di servizio.
Lo standard prevede due superfici: l'elemento HTML <install>, senza JavaScript e con pulsante gestito dal browser, e il metodo navigator.install(), che consente pulsanti personalizzati e installazioni cross-origin con un consenso aggiuntivo. In entrambi i casi il browser mostra sempre una finestra di conferma prima di installare.
A che punto sono i browser
Il supporto è oggi asimmetrico, e questo cambia molto l'esperienza reale. Chrome è il primo browser a offrire l'API in versione stabile, dopo una fase sperimentale; Edge ha aperto la sperimentazione con un origin trial e ha proseguito nelle versioni successive. Firefox non supporta l'API e non risulta una posizione ufficiale sul tema. WebKit, il motore di Safari, si è dichiarato contrario allo standard. La conseguenza pratica è che su iPhone e iPad, dove tutti i browser usano il motore di WebKit, l'API non è disponibile: chi vuole installare una web app su iOS deve ancora passare dal menu di condivisione di Safari.
| Browser | Supporto | Da quale versione | Note |
|---|---|---|---|
| Chrome | Sì, stabile | 158, da metà novembre 2026 | Prima disponibile solo tramite flag sperimentali |
| Microsoft Edge | Sì, origin trial | 143, da novembre 2025 | Supporto proseguito nelle versioni successive |
| Firefox | No | — | Nessuna posizione ufficiale pubblicata |
| Safari (WebKit) | No | — | Posizione contraria allo standard |
Su iPhone e iPad tutti i browser usano il motore WebKit, quindi l'API non è disponibile nemmeno installando Chrome da App Store. Su iOS resta il percorso manuale dal menu di condivisione di Safari: non rimuovere le istruzioni per l'utente solo perché l'API funziona su desktop.
Come implementarla in tre passaggi
L'adozione non richiede una riscrittura del sito. Servono tre condizioni: un sito servito in HTTPS, un'applicazione web installabile con manifest valido e un punto di ingresso per la richiesta di installazione. Prima di tutto, però, verifica che il sito sia effettivamente raggiungibile e correttamente indicizzato: un'API di installazione su una pagina che i motori non conoscono serve a poco, e la procedura per verificare l'indicizzazione su Google e Bing è il controllo da fare per primo.
Passaggio 1 — Rendere il sito installabile
Il sito deve essere servito in HTTPS e disporre di un manifest collegato nella sezione head della pagina, con le icone raggiungibili e della dimensione corretta. Senza questi elementi il browser non considera l'applicazione installabile e la richiesta non produce alcun effetto. Verifica anche che il manifest sia raggiungibile senza errori di autenticazione: un manifest protetto da login blocca l'installazione.
Passaggio 2 — Preparare il manifest per installare una PWA
Se vuoi installare una PWA in modo affidabile su tutti i dispositivi, il manifest deve dichiarare un identificativo stabile, nome e nome breve coerenti con l'icona, colori di tema e sfondo, e la modalità di visualizzazione desiderata. Aggiungi almeno le icone nelle dimensioni richieste dai diversi sistemi, comprese quelle dichiarate come maskable, altrimenti su Android l'icona appare ritagliata in modo imprevedibile. Un errore frequente è cambiare l'identificativo durante un restyling: il browser tratta il risultato come una nuova app e l'utente perde il collegamento con quella già installata.
Passaggio 3 — Aggiungere il pulsante e gestire i browser non compatibili
Con l'API disponibile, inserisci l'elemento <install> nella pagina oppure chiama navigator.install() da un tuo pulsante. In entrambi i casi devi prevedere il fallback: se l'API non esiste, la chiamata non produce errori visibili e l'utente resta senza istruzioni. Mostra quindi un messaggio alternativo con le indicazioni per il browser in uso, e non proporre la richiesta a ogni visita: una sola volta, in un momento in cui l'utente ha già dimostrato interesse per il servizio.
- Servi il sito in HTTPS e collega un manifest valido con icone raggiungibili.
- Dichiara nel manifest un identificativo stabile e le icone nelle dimensioni richieste.
- Aggiungi l'elemento <install> o un pulsante con navigator.install(), e prepara il messaggio di fallback per i browser che non supportano l'API.
Cosa cambia per sviluppatori e cataloghi di app
La funzione che sposta davvero gli equilibri è l'installazione cross-origin. Un sito può diventare un catalogo da cui installare più applicazioni web, anche pubblicate su domini diversi, senza passare da un app store e senza le sue commissioni. Nascono così forme di distribuzione che prima non esistevano: una suite di strumenti che installa i suoi moduli, un portale di servizi pubblici che offre le sue app, un marketplace che distribuisce applicazioni web di terze parti. Il modello ricorda quello degli store, ma con una differenza sostanziale: non c'è un intermediario che approva le app, e quindi la responsabilità della selezione ricade interamente su chi pubblica il catalogo. Per chi gestisce l'infrastruttura su cui girano queste applicazioni, la guida pratica a web hosting e VPS aiuta a capire quali configurazioni reggono carichi distribuiti.
Limiti, sicurezza e rischi
Il primo limite è il supporto parziale: finché Safari non implementa l'API, una fetta rilevante del traffico mobile resta fuori. Il secondo è il rischio di abuso. Un'API che permette di chiedere l'installazione è anche un'API che permette di chiedere l'installazione troppo spesso, e la lezione dei banner sui cookie insegna che la disponibilità tecnica non basta a garantire un buon comportamento. I browser hanno introdotto limiti al numero di elementi <install> per pagina e mantengono la conferma obbligatoria, ma la qualità dell'esperienza dipenderà da come i siti useranno lo strumento. Il terzo limite è di fiducia: un catalogo cross-origin che installa app di terzi diventa un punto di attacco interessante, e la verifica dei domini da cui si installa è un passaggio che nessun team dovrebbe saltare.
Non mostrare la richiesta di installazione al primo caricamento della pagina. Proponila dopo che l'utente ha completato un'azione significativa, come la seconda visita o il primo salvataggio di un contenuto: in quel momento l'installazione è una risposta a un bisogno, non un ostacolo.
Errori comuni quando si adotta la Web Install API
Il primo errore è dimenticare il fallback: su Safari e Firefox il pulsante non fa nulla e l'utente resta convinto che il sito sia rotto. Il secondo è cambiare l'identificativo del manifest a ogni aggiornamento, creando installazioni duplicate. Il terzo è proporre l'installazione in modo invasivo, con un banner fisso che copre i contenuti: il risultato è che l'utente impara a chiudere il banner senza leggere, e la funzione perde efficacia. Il quarto è non misurare: senza sapere quante installazioni vengono completate e quante richieste vengono rifiutate, non è possibile capire se lo strumento sta funzionando. Il quinto, il più insidioso, è dare per scontato che l'API risolva il problema della scoperta da sola: un'applicazione web installabile deve prima di tutto essere utile, altrimenti nessun pulsante la renderà desiderabile.
Riepilogo: cosa sapere prima di implementarla
| Situazione | Cosa fare | Cosa evitare |
|---|---|---|
| Sito nuovo, senza manifest | Creare il manifest con identificativo stabile e icone complete | Aggiungere l'elemento <install> prima del manifest |
| Pubblico con molti utenti iOS | Mantenere le istruzioni dal menu di condivisione di Safari | Mostrare solo il pulsante basato sull'API |
| Catalogo con app di terzi | Verificare i domini e spiegare il consenso aggiuntivo | Installare app senza indicare la provenienza |
| Prima visita di un nuovo utente | Rimandare la richiesta a un momento di interesse reale | Banner fisso che copre i contenuti |
Fonti
- Chrome for Developers, Web Install API: documentazione ufficiale dell'API, elementi <install> e navigator.install(), requisiti del manifest e gestione del consenso.
- WICG, Web Install API explainer: specifica di riferimento con i due approcci, il caso cross-origin e le limitazioni anti-abuso per pagina.
- Microsoft Edge Explainers, Web Install: descrizione dell'origin trial avviato da Microsoft e comportamento nei browser non compatibili.
- WebKit, Standards Positions: elenco ufficiale delle posizioni di WebKit sugli standard web, inclusa la contrarietà alla Web Install API.
Domande frequenti
La Web Install API funziona su iPhone e Safari?
La Web Install API non è supportata su iPhone e iPad, perché tutti i browser iOS usano il motore WebKit, che ha una posizione contraria allo standard. Su questi dispositivi resta il percorso manuale dal menu di condivisione di Safari, con la voce che aggiunge il sito alla schermata Home.
Come si fa a installare una web app su iPhone?
Per installare una web app su iPhone si apre il sito in Safari, si tocca il pulsante di condivisione e si sceglie l'opzione per aggiungere alla schermata Home. La procedura non richiede app store né account, e l'icona compare insieme alle altre applicazioni del telefono.
Serve un app store per distribuire un'applicazione web?
Un'applicazione web installabile non richiede un app store: viene servita dal sito che la ospita e il browser la installa su richiesta dell'utente. Questo non elimina la necessità di un dominio, di un certificato HTTPS e di un manifest valido, ma evita le procedure di approvazione e le commissioni degli store.
La Web Install API può installare app pubblicate su altri domini?
La Web Install API consente l'installazione cross-origin solo tramite il metodo navigator.install(), non con l'elemento <install>. In questo caso il browser richiede un consenso aggiuntivo rispetto all'installazione di un'app dello stesso dominio, per rendere esplicita la provenienza dell'applicazione.
Cosa succede se il browser non supporta l'API?
Se il browser non supporta l'API, la chiamata a navigator.install() non produce alcun effetto e l'elemento <install> non viene mostrato. Per questo è necessario prevedere un messaggio alternativo con le istruzioni per il browser in uso, altrimenti l'utente vede un pulsante che non fa nulla.
Vale la pena adottarla oggi?
Per un sito che serve soprattutto utenti desktop su Chrome ed Edge, adottare la Web Install API oggi è ragionevole: il costo di implementazione è basso e il beneficio, in termini di installazioni completate, è misurabile in poche settimane. Per un servizio con un pubblico mobile ampio, l'API va vista come un'aggiunta e non come una sostituzione: le istruzioni manuali per iOS restano necessarie e vanno scritte bene, perché sono ancora il percorso principale per gran parte degli utenti italiani. La domanda giusta non è se lo standard vincerà, ma se la vostra applicazione web merita di stare un clic più vicino all'utente. Se la risposta è sì, il pulsante è il dettaglio più semplice da sistemare. Per chi lavora sulla visibilità dei contenuti, la guida su farsi citare da ChatGPT: guida SEO completa il quadro su come i contenuti vengono trovati oggi.
📲 Ricevi ogni giorno le novità su IA, Mac e iPhone: segui il canale WhatsApp di Gedix.
Se vuoi approfondire, leggi la nostra guida su farsi citare da ChatGPT: guida SEO.
html