Missing Metadata App Store Connect: sbloccare un abbonamento

Missing Metadata in App Store Connect significa che al tuo abbonamento o al tuo acquisto in-app manca almeno un'informazione obbligatoria. Controlla nell'ordine la lingua, il prezzo, la durata, i paesi, lo screenshot di revisione e il contratto per le app a pagamento. Finché il prodotto resta in questo stato, non puoi mandarlo in revisione e la tua app non può caricarlo. In più, il primo abbonamento deve partire insieme a una versione dell'app.

Ho avuto questo stato a luglio 2026 su TradaZen, il mio simulatore di trading. Il nuovo abbonamento settimanale aveva la sua durata, il suo prezzo, il suo gruppo e due lingue. Eppure restava in Missing Metadata. L'unico elemento mancante era lo screenshot di revisione. Ecco le cause da controllare, gli stati di un prodotto con ciò che sblocca ciascuno, e poi il legame con RevenueCat.

Cosa significa Missing Metadata?

Fino a quest'anno, l'aiuto di Apple definiva questo stato così: il prodotto è stato creato, ma non hai ancora caricato uno screenshot o completato i suoi metadati. Lo stato non dice mai quale campo manca. Il problema è tutto qui: bisogna cercare.

Attenzione, l'etichetta è cambiata a luglio 2026. Le note di rilascio di App Store Connect annunciano al 15 luglio una nuova modalità di invio: ogni acquisto in-app si invia dalla propria pagina, con Add for Review. La pagina degli stati non elenca più "Missing Metadata". Comincia con "Prepare for Submission" e precisa: se al tuo acquisto in-app mancano metadati obbligatori, completali prima di aggiungerlo a un invio. La documentazione di RevenueCat lo conferma: prima della revisione, un nuovo prodotto appare in "Prepare for Submission", anche se gli mancano dei metadati.

L'API di App Store Connect, invece, restituisce ancora MISSING_METADATA e poi READY_TO_SUBMIT. Gli strumenti che si basano su di essa mostrano quindi ancora queste parole. Qualunque sia l'etichetta, la diagnosi è la stessa: un campo obbligatorio è vuoto.

Le cause da controllare, nell'ordine

Le controllo in quest'ordine, dalla pagina del prodotto fino all'account.

Causa	Dove correggere
Nome o descrizione vuoti	Pagina del prodotto
Gruppo senza nome visualizzato	Pagina del gruppo
Prezzo o durata mancanti	Pagina del prodotto
Nessun paese disponibile	Availability
Screenshot di revisione assente	Review Information
Contratto a pagamento inattivo	Business
Primo abbonamento da solo	Invio

1. La lingua del prodotto. Secondo la scheda delle informazioni di un acquisto in-app, il nome visualizzato e la descrizione sono obbligatori in almeno una lingua. Il nome va da 2 a 30 caratteri, la descrizione al massimo 45. Un prodotto senza lingua non può partire.

2. La lingua del gruppo. Anche il gruppo di abbonamenti ha un nome visualizzato, che i tuoi abbonati vedono quando gestiscono gli abbonamenti sull'iPhone. Si aggiunge nella pagina del gruppo, sezione Display Name and Description, come spiega la pagina di Apple sugli abbonamenti. Il campo non sembra obbligatorio. Eppure uno sviluppatore racconta sui forum di Apple che tutti gli abbonamenti del suo gruppo restavano bloccati finché era vuoto. Lo stato compare sull'abbonamento, non sul gruppo, da qui la confusione.

3. Il prezzo e la durata. Un abbonamento richiede una durata, da una settimana a un anno, e un prezzo. La nota tecnica TN3186 parte da qui quando un prodotto non si carica: controllare l'identificativo, il prezzo e le lingue. Ricorda anche che la durata non si può più modificare dopo l'invio in revisione.

4. La disponibilità. Scegli almeno un paese o una regione in Availability. Apple precisa che, senza disponibilità, lo stato "Approved" non può comparire.

5. Lo screenshot di revisione. È il mio caso su TradaZen, e una causa che torna spesso sui forum. Lo screenshot "App Review Screenshot" mostra l'acquisto così come appare nell'app, di solito il tuo paywall. Serve solo al revisore e non viene mai mostrato sull'App Store. Segue i formati dei tuoi screenshot App Store. Una volta caricato, puoi sostituirlo, non eliminarlo.

Non confonderlo con l'immagine promozionale da 1024 x 1024 pixel. Quella serve solo se metti in evidenza l'acquisto sulla tua scheda o se crei un'offerta di riconquista, e ha le sue regole. L'ho imparato con un rifiuto sull'immagine promozionale di un abbonamento.

6. Il contratto per le app a pagamento. Per offrire acquisti in-app, il titolare dell'account deve firmare il Paid Apps Agreement in Business, poi inserire i dati bancari e fiscali. Non è un campo del prodotto, ma tutto dipende da lì. Apple scrive che non puoi creare un nuovo acquisto in-app finché non hai accettato l'ultima versione del contratto. La sua pagina sulla preparazione degli acquisti per la revisione aggiunge che gli acquisti a pagamento non funzionano in revisione finché questo contratto non è attivo. In Business, il contratto, il conto bancario e i moduli fiscali devono essere tutti attivi. Questi passaggi sono spiegati nella guida all'account sviluppatore Apple.

7. Il primo abbonamento inviato da solo. Non è un metadato mancante. Eppure è il motivo più comune per cui un prodotto completo non parte mai in revisione. Lo spiego più sotto.

Gli stati di un prodotto e cosa sblocca ciascuno

Ecco la checklist che tengo sotto gli occhi. La prima colonna indica lo stato restituito dall'API, la seconda l'etichetta dell'aiuto di Apple da luglio 2026.

Stato (API)	Etichetta attuale	Cosa sblocca
MISSING_METADATA	Prepare for Submission	Compilare i campi
READY_TO_SUBMIT	Prepare for Submission	Add for Review
Nessun equivalente	Ready for Review	Submit for Review
WAITING_FOR_REVIEW	Waiting for Review	Aspettare Apple
IN_REVIEW	In Review	Aspettare Apple
APPROVED	Approved	Paesi e app approvata
REJECTED	Rejected	Correggere, Update Review

Nel dettaglio:

• Da Missing Metadata a Ready to Submit. Compila i campi delle cause da 1 a 5, salva, ricarica la pagina. La schermata che avevo a luglio mostrava Missing Metadata, e lo stato successivo si chiamava Ready to Submit.
• Da Ready to Submit a Ready for Review. Nella pagina dell'abbonamento, clicca su Add for Review e aggiungilo a un invio esistente o a uno nuovo. La procedura di invio di un acquisto in-app ti fa scegliere la piattaforma, la versione dell'app e, se serve, il gruppo. Da quel momento restano modificabili solo il nome di riferimento, il prezzo e la disponibilità.
• Da Ready for Review a Waiting for Review. Controlla che la versione dell'app e il gruppo siano nello stesso invio, poi clicca su Submit for Review.
• Da Waiting for Review ad Approved. Niente da fare, a parte tenere il paywall funzionante. Se l'acquisto passa in "Accepted" e non in "Approved", un altro elemento dello stesso invio è stato rifiutato: Apple non approva nulla finché tutto non è accettato.
• Rejected. Il motivo compare nei messaggi dell'invio. Correggi l'elemento, clicca su Update Review, poi rimanda l'invio.

Il primo abbonamento parte con una versione dell'app

La regola è nell'aiuto di Apple: il primo abbonamento, come il primo acquisto di ogni tipo, deve essere inviato con una nuova versione dell'app. Un nuovo gruppo parte con almeno uno dei suoi abbonamenti. Una volta approvato questo primo elemento, puoi inviare i successivi dello stesso tipo senza una nuova versione, purché l'app abbia una versione approvata.

È quello che è successo su TradaZen. La versione di luglio è partita con l'annuale e il mensile. Il settimanale, ancora in Missing Metadata, è rimasto fuori dall'invio. Una volta approvata l'app, poteva partire da solo, senza una nuova build.

Se invii l'app senza il suo abbonamento, servirà una nuova versione per farlo approvare. La guida sui tempi di approvazione dell'App Store mostra quanti giorni costa questo ciclo in più.

Il legame con RevenueCat: l'offerta vuota

RevenueCat non vende niente da solo. L'SDK legge gli identificativi dei tuoi prodotti sui suoi server, poi chiede i prodotti all'App Store, dall'iPhone. Se l'App Store non li restituisce, l'offerta arriva vuota e il tuo paywall non ha niente da mostrare. I log dell'SDK mostrano allora: "There's a problem with your configuration. None of the products registered in the RevenueCat dashboard could be fetched from the App Store."

Secondo RevenueCat, un prodotto con metadati completi si carica in sandbox ancora prima della revisione. Un prodotto incompleto no. Le altre piste indicate da RevenueCat e Apple:

• il contratto per le app a pagamento e i dati bancari, che possono metterci fino a 24 ore a propagarsi secondo RevenueCat;
• una modifica del prodotto, che può metterci fino a un'ora ad arrivare in sandbox secondo Apple;
• un identificativo di prodotto diverso tra App Store Connect, RevenueCat e il tuo codice.

Su TradaZen, il codice nasconde la card di un abbonamento il cui prodotto non viene restituito, senza rompere il paywall. A ottobre 2026 ho visto un paywall senza offerta per un altro motivo: l'offerta letta dalla cache dell'SDK era vuota. Da allora, se l'offerta è vuota, il codice dell'app chiede i prodotti direttamente a StoreKit, e propone di riprovare se lo store non risponde.

Un paywall senza offerta non deve mai essere un vicolo cieco, né per l'utente né per il revisore, che deve poter acquistare. La configurazione completa è nella mia guida RevenueCat per un abbonamento iOS, e le trappole di visualizzazione negli errori di paywall. Una volta pronto il prodotto, controlla anche che il paywall rispetti la guideline 3.1.2.

Collegare il tuo abbonamento senza perderci la settimana

L'iOS & Android Kit parte dal codice di base delle mie app: onboarding, paywall e abbonamenti sono già pronti, e il suo terzo passaggio, "collegare i soldi", ti guida nella configurazione. Tutta la catena, dai prodotti App Store Connect alla verifica dell'acquisto, è descritta nella pagina abbonamento in-app iOS.

Se stai preparando la tua prima uscita, fai la tua diagnosi gratuita: rimette i passaggi in ordine e ti manda la mia checklist anti-rifiuto di Apple. Se il tuo abbonamento resta bloccato nonostante tutto questo, prenota un'ora con me: apriamo insieme il tuo App Store Connect e cerchiamo il campo vuoto.

Domande frequenti

Perché il mio abbonamento resta in Missing Metadata anche se è tutto compilato?

Controlla prima lo screenshot di revisione, poi il nome visualizzato del gruppo di abbonamenti, che non sembra obbligatorio. Verifica poi il prezzo, la durata, almeno un paese e il contratto per le app a pagamento in Business. Dopo ogni correzione, salva e ricarica la pagina prima di trarre conclusioni.

Serve uno screenshot per un abbonamento?

Sì, lo screenshot di revisione, chiamato App Review Screenshot. Mostra l'acquisto nell'app, di solito il paywall, e serve solo al revisore. Non compare sull'App Store. Non confonderlo con l'immagine promozionale da 1024 x 1024 pixel, utile solo per mettere in evidenza l'acquisto o per un'offerta di riconquista.

Si può inviare un abbonamento senza una nuova versione dell'app?

Il primo no. Il primo abbonamento e il suo gruppo partono con una nuova versione dell'app. Una volta approvato questo primo abbonamento, i successivi possono partire da soli, purché l'app abbia una versione approvata.

Cosa significa Prepare for Submission per un acquisto in-app?

È l'etichetta dell'aiuto di Apple da luglio 2026 per un prodotto non ancora aggiunto a un invio. Compare anche se mancano dei metadati. L'API di App Store Connect distingue ancora i due casi, con MISSING_METADATA e READY_TO_SUBMIT.

Perché RevenueCat restituisce un'offerta vuota?

Perché l'App Store non ha restituito nessun prodotto all'iPhone. Le cause più comuni: metadati incompleti, contratto per le app a pagamento inattivo, identificativo di prodotto diverso, o una modifica recente non ancora propagata. Il tuo paywall deve gestire questo caso senza bloccare l'utente.