Universal Links su Shopify, Webflow, Wix e Squarespace: quali piattaforme possono ospitare il file AASA
Se i link della tua app aprono il sito web invece dell’app, di solito iOS e Android non hanno trovato due piccoli file sul tuo dominio. Cosa ti lascia ospitare ogni piattaforma a ottobre 2026, la strada del sottodominio quando la tua dice di no e un link che non ha bisogno di nessun file.
Apri la tua app da un link senza mettere mano alla piattaforma del tuo sito
- Routing verso gli store su tutti i piani, Free compreso
- Deep link che aprono l’app con Pro
- Niente da caricare sul tuo sito web
Perché il link apre il tuo sito web
Un Universal Link è un normale link https che iOS passa alla tua app invece che a Safari. Su Android la sua versione si chiama App Link. Prima di aprire nella tua app un link di yourbrand.com, entrambi i telefoni scaricano da yourbrand.com un file che indica l’app. Niente file leggibile, niente app: il link apre il sito web.
Sulle piattaforme per creare siti, di solito è proprio quel file a mancare. Il tuo sviluppatore ha già sistemato la parte dell’app. La parte del sito web richiede un file a un indirizzo fisso, ed è la piattaforma a decidere cosa puoi metterci.
L’indirizzo che controllano entrambi i telefoni
iOS controlla questo URL su ogni dominio indicato dalla tua app. Android cerca assetlinks.json nella stessa cartella.
https://yourbrand.com/.well-known/apple-app-site-association
https://
HTTPS, niente redirect
Un certificato valido e una risposta diretta, senza 301 né 302.
yourbrand.com
L’host esatto
Ogni sottodominio serve il proprio file. www.yourbrand.com è un host a parte.
/.well-known/
Una cartella fissa
Il percorso non si può spostare. Le piattaforme si distinguono proprio qui: se ti lasciano scriverci o no.
apple-app-site-association
Senza estensione
Dentro c’è JSON, ma il nome non ha .json. Il file di Android è assetlinks.json.
Cosa ti lascia ospitare ogni piattaforma
Dalle pagine di aiuto e dalla documentazione per sviluppatori di ciascuna piattaforma, al 23 ottobre 2026.
Piattaforma per piattaforma
Webflow. Dal 16 dicembre 2024 Webflow serve qualsiasi file well-known. Nel pannello Assets crea una cartella chiamata well-known, carica i file e pubblica. I file caricati devono finire in .json, .txt o .md, quindi chiama il file iOS apple-app-site-association.noext.txt e Webflow toglierà l’estensione. assetlinks.json si carica così com’è. I nuovi file richiedono un piano Premium Site (o il vecchio piano Business Site) e non funzionano sui domini di staging webflow.io.
Framer. In Site Settings apri Hosting, poi Files. Aggiungi ogni file con il percorso /.well-known e pubblica. Framer cita entrambi i file per nome e accetta file senza estensione. La funzione è disponibile sui piani Pro ed Enterprise. Framer non dice con quale tipo di contenuto viene servito un file senza estensione, quindi controllalo dopo la pubblicazione.
Shopify. Shopify non documenta un modo per caricare nessuno dei due file. Li genera da sé sul tuo dominio personalizzato, mai su *.myshopify.com, una volta registrata la tua app: nelle impostazioni Storefront API di un’app personalizzata oppure tramite la MobilePlatformApplication API, il cui scope va abilitato dal supporto Shopify. Il file iOS finisce con /*, quindi ogni URL del negozio, tranne /admin e due callback di pagamento, apre l’app. A maggio 2026 uno sviluppatore ha chiesto di poter controllare i percorsi; il 14 ottobre Shopify non aveva aggiornamenti da condividere.
Wix. Wix non documenta un modo per servire file in /.well-known/ (verificato a ottobre 2026). Il suo centro assistenza dice che al momento non è possibile aggiungere un file di verifica alla radice di un dominio, e lo dice in una richiesta di funzionalità che sta ancora raccogliendo voti.
Squarespace. Anche qui nessun metodo documentato. La sua pagina di aiuto sui file spiega che è la CDN ad assegnare gli URL dei file e che non si possono modificare. La soluzione che gira sul suo forum è una mappatura URL con redirect 301, che sia Apple sia Google rifiutano.
La strada del sottodominio
Se la tua piattaforma dice di no, o se il file di Shopify, che manda ogni URL all’app, va oltre quello che ti serve, lascia il sito web dov’è. Punta un sottodominio come links.yourbrand.com a un hosting statico come Netlify, Vercel, Cloudflare Pages o Firebase Hosting; tutti e quattro permettono di impostare gli header di risposta per percorso. Del resto la TN3155 di Apple suggerisce già un sottodominio separato per un caso affine: dal browser, un link da una pagina di yourbrand.com a un’altra non apre l’app, mentre un link verso un altro sottodominio sì.
Cambiano due cose. I link che condividi devono puntare al sottodominio; i link alle pagine di yourbrand.com continuano ad aprire il sito web. E l’app va aggiornata: applinks:links.yourbrand.com in Associated Domains e, su Android, un intent filter con autoVerify per quell’host. Dai una destinazione anche a tutti gli altri percorsi del sottodominio, per esempio un redirect al tuo sito web, così chi non ha l’app non finisce su un 404.
I tre file
Sostituisci ID e impronta con i tuoi. Il generatore li compila per te.
.well-known/apple-app-site-association
{
"applinks": {
"details": [
{
"appIDs": ["ABCDE12345.com.yourbrand.app"],
"components": [
{ "/": "/*", "comment": "Every link on this subdomain opens the app" }
]
}
]
}
}.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.yourbrand.app",
"sha256_cert_fingerprints": ["14:6D:E9:83:...:3F:CF:44:E5"]
}
}]_headers (Netlify)
/.well-known/apple-app-site-association
Content-Type: application/json
/.well-known/assetlinks.json
Content-Type: application/jsonConfigurare links.yourbrand.com
Con Netlify come esempio. Gli altri hosting seguono gli stessi passaggi, con i propri valori per il record.
- 01
Fai il deploy della cartella
Dominio
links.yourbrand.com
La cartella .well-known con i due file, più _headers. Poi aggiungi links.yourbrand.com al sito in Netlify.
- 02
Aggiungi un record CNAME
- Tipo
- CNAME
- Nome
- links
- Valore
- your-site.netlify.app
Lì dove gestisci il DNS, magari nelle impostazioni di dominio della tua piattaforma. I record del sito web restano dove sono. La propagazione può richiedere un giorno.
- 03
HTTPS, poi il controllo
- In attesa del DNS
- Certificato emesso
- Entrambi i file si caricano
https://links.yourbrand.com/.well-known/assetlinks.json
Netlify emette e rinnova un certificato Let’s Encrypt per il sottodominio. Poi passalo al validatore.
Oppure fai a meno del file
Un Universal Link non è l’unica porta d’ingresso alla tua app. Con Pro ($9.99/mese), un link Appy porta con sé, accanto agli indirizzi dei tuoi store, il deep link con lo URL scheme della tua app, come yourapp://product/42. In Safari e Chrome prova l’app, poi lo store. Nei browser in-app come quello di Instagram mostra una pagina con un pulsante «Apri l’app», un pulsante per lo store e i passaggi per aprire Safari o Chrome. I computer arrivano sul tuo sito web. Sul sito non devi mettere niente.
Però non è un Universal Link sul tuo dominio. Il link sta su appy.to, e yourbrand.com/product/42 continua ad aprire il sito web. Apple raccomanda caldamente gli Universal Links rispetto agli schemi, anche perché nulla impedisce a un’altra app di registrare il tuo. Con Business, un dominio personalizzato come go.yourbrand.com porta i tuoi link ma fa solo redirect; Universal Links e App Links sul tuo dominio tramite Appy fanno parte di Enterprise. Con il sottodominio visto sopra, un link Pro può usare https://links.yourbrand.com/product/42 come deep link, e i telefoni senza l’app arrivano comunque allo store.
Controlla prima di condividere un link
Genera entrambi i file
Il generatore su /tools/aasa-assetlinks-generator li crea a partire da Team ID, bundle ID, nome del pacchetto e impronta.
Valida l’host
Il validatore su /tools/universal-link-validator scarica il file AASA dal tuo server e la copia nella CDN di Apple, e controlla che assetlinks.json contenga il nome del tuo pacchetto e la tua impronta.
Dai tempo alla CDN di Apple
Gli iPhone leggono il file dalla CDN di Apple, che lo scarica entro 24 ore. I telefoni controllano circa una volta a settimana; reinstallando l’app si scarica una copia aggiornata.
Tocca un link vero
Incollalo in Note o invialo a te stesso in Messaggi, poi toccalo su un telefono con l’app installata. Su Android, adb shell pm get-app-links con il nome del tuo pacchetto dovrebbe mostrare l’host come verified.
Leggi anche
- Guida completa agli Universal LinksIl lato app: entitlement, intent filter e percorsi.
- Gli Universal Links aprono Safari?Le cause più comuni quando il file è già al suo posto.
- Android App Links non verificatiUna diagnosi in cinque minuti con adb.
- Domini personalizzatiIl tuo dominio per i link con Business, i link all’app con Enterprise.
Universal Links sulle piattaforme per siti: domande e risposte
Posso caricare apple-app-site-association su Shopify?
Non come file. Shopify lo genera sul tuo dominio personalizzato dopo la registrazione della tua app, e manda all’app ogni URL del negozio. Su myshopify.com non funziona.
Come aggiungo un file .well-known in Webflow?
Crea una cartella chiamata well-known nel pannello Assets, carica il file e pubblica. Chiama il file iOS apple-app-site-association.noext.txt, così viene servito senza estensione. I nuovi file richiedono un piano Premium Site o superiore.
Wix e Squarespace supportano gli Universal Links?
Nessuno dei due documenta un modo per servire file in /.well-known/ (verificato a ottobre 2026). Ospita i file su un sottodominio con un hosting statico, oppure usa un link che apre l’app con uno URL scheme.
Un redirect può far puntare /.well-known/ a un file ospitato altrove?
No. Apple richiede il file senza redirect, e il file di Android deve caricarsi senza 301 né 302.
Gli Universal Links funzionano senza un sito web?
Hanno bisogno di un dominio che fornisca il file, non del tuo sito web principale, quindi basta un sottodominio su un hosting statico. Un deep link con URL scheme che passa da uno smart link apre l’app senza alcun file, ma non è un Universal Link.
Ho corretto il file. Perché il link apre ancora il sito web?
Gli iPhone leggono il file dalla CDN di Apple, che lo scarica entro 24 ore, e le app installate controllano circa una volta a settimana. Reinstalla l’app per provare il nuovo file.
Continua a esplorare
Universal Links e App Links: i codici di errore spiegati
Cosa significano SWCERR00101, SWCERR00301, legacy_failure e 1026, dove trovarli e come correggerli perché Universal Links e App Links tornino ad aprire la tua app.
Come i browser in-app gestiscono i deep link: Instagram, TikTok, Facebook, Gmail, Telegram e altri
Il tuo link apre l’app da Safari ma non dentro Instagram. Cosa fanno i browser in-app di Instagram, TikTok, Facebook, Gmail, Telegram e altri, le regole di iOS e Android e come prevedere un fallback.
Link brevi sul tuo dominio per le app: guida pratica
Perché conviene avere i link sul tuo dominio, come scegliere il sottodominio, la configurazione in tre passaggi e cosa succede ai link e ai QR code che hai già condiviso.
Cerchi altro? Sfoglia tutti gli argomenti su il blog.
Controlla il tuo dominio in un minuto
Passa il tuo sito web o il tuo sottodominio al validatore gratuito: il file AASA sul tuo server, la copia nella CDN di Apple e assetlinks.json in un solo controllo. Se la tua piattaforma non può ospitare i file, un deep link Appy apre l’app anche senza.