iOS-update publiceren: gefaseerde release in 7 dagen

Om een iOS-update te publiceren, maak je in App Store Connect een nieuwe versie aan met een hoger nummer. Je koppelt er een nieuwe build aan, schrijft de tekst bij "What's New" en stuurt hem naar App Review. Elke nieuwe versie gaat opnieuw door de review van Apple, ook als het maar een kleine bugfix is. Voordat je hem instuurt, kies je hoe hij na goedkeuring uitkomt: handmatig, meteen, niet vóór een bepaalde datum, of als gefaseerde release over 7 dagen.

De gefaseerde release geldt alleen voor automatische updates: 1% van die gebruikers op de eerste dag, iedereen op de zevende. Je kunt hem in totaal tot 30 dagen pauzeren, of hem in één keer afronden. Deze gids volgt de helppagina's van Apple, nagelezen op 3 november 2026.

Ik publiceer de updates van mijn iOS-apps met Expo en EAS, waaronder Solys, TradaZen en Nolera. De voorbeelden hieronder komen uit die releases.

Een iOS-update publiceren: de stappen op volgorde

De hulp van App Store Connect over nieuwe versies geeft dit stappenplan:

1. Kies in Apps je app en klik op de knop + naast het platform.
2. Vul een versienummer in dat hoger is dan het vorige en klik op Create.
3. Controleer de metadata: die van de live versie worden automatisch overgenomen.
4. Upload een nieuwe build met een opgehoogd buildnummer.
5. Test die build in TestFlight, voeg hem toe aan de versie en dien hem in bij App Review.

Twee voorwaarden voordat je begint. De live versie moet de status Ready for Distribution hebben. En je hebt een van deze rollen nodig: Account Holder, Admin, App Manager of Marketing.

Terugdraaien bestaat niet. Apple schrijft het op dezelfde pagina: als een versie problemen geeft, kun je niet terug naar de vorige. Je moet een nieuwe versie maken en indienen.

Versienummer en buildnummer

De versie is het nummer dat je klanten op je productpagina zien. De build identificeert elke upload. De combinatie van versie en build moet uniek zijn: de regels en bijbehorende foutmeldingen staan in versie- en buildnummer.

Mijn eigen afspraak, geen regel van Apple: het laatste cijfer gaat omhoog bij een bugfix, van 1.4.0 naar 1.4.1. Het middelste gaat omhoog bij een nieuwe functie, van 1.4.1 naar 1.5.0. Het buildnummer gaat alleen maar omhoog, van versie tot versie. Met Expo staat de versie in app.json en kan EAS de build bij elke productiebuild ophogen. Hoe je dat instelt, lees je in een Expo-app publiceren met EAS.

De tekst bij "What's New": wat Apple eist

De pagina over versie-informatie beschrijft het veld What's New in This Version:

• Maximaal 4.000 tekens.
• Niet aanwezig bij de eerste versie, verplicht bij alle volgende.
• Te vertalen in elke taal van je productpagina.

Regel 2.3.12 van de App Review Guidelines voegt een eis toe: beschrijf nieuwe functies en productwijzigingen duidelijk. Voor gewone bugfixes en beveiligings- of prestatieverbeteringen volstaat een algemene formulering. Een belangrijke wijziging moet je opsommen. "Bugfixes en verbeteringen" is dus niet genoeg voor een versie die je abonnement of je hoofdscherm verandert.

Op zijn pagina over beoordelingen raadt Apple ook aan om in de notities problemen te noemen die je hebt opgelost en die klanten in hun reviews beschreven.

Hier zijn drie sjablonen om aan te passen, één per type versie.

Voor een bugfix:

Fixes en stabiliteit.
- [Functie]: [wat niet werkte] is opgelost.
- [Scherm] laadt sneller.
Dank aan iedereen die het heeft gemeld.

Voor een nieuwe functie:

Nieuw: [de functie, in vijf woorden].
[Wat je nu kunt doen, in één zin.]
Waar je het vindt: [tabblad] > [knop].

Ook in deze versie:
- [Zichtbare verbetering].
- Bugfixes.

Voor een flow die verandert:

[Scherm of flow] verandert.
- Wat er voor jou verandert: [concreet effect].
- Wat je houdt: [gegevens, instellingen, aankoop].
Een vraag? [Instellingen] > [Help].

De laatste regel van het bugfix-sjabloon geldt alleen als iemand het probleem echt heeft gemeld. Schrijf nooit een nieuwigheid op die niet in de build zit: regel 2.3 vraagt metadata die kloppen met de app.

Handmatige, automatische of geplande release

De hulp over release-opties biedt er drie:

Optie	Na goedkeuring door Apple
Manually release this version	Status Pending Developer Release, jij publiceert wanneer je wilt
Automatically release this version	De versie komt uit zodra hij is goedgekeurd
Automatically release this version after App Review, no earlier than...	Hij wacht tot de gekozen datum en komt dan vanzelf uit

Bij een handmatige release open je de versie met de status Pending Developer Release, klik je op Release This Version en bevestig je. Apple waarschuwt dat het tot 24 uur kan duren voordat hij in de App Store verschijnt. Een melding op de versiepagina biedt Cancel This Release om te annuleren. Blijft de versie langer dan 30 dagen wachten, dan stuurt Apple je een herinnering per e-mail.

Met een handmatige release kies je het moment, bijvoorbeeld om te publiceren op de dag van een aankondiging. Solys 2.0.0, met een nieuwe versie van het jaarabonnement, ging eind september 2026 in review met een handmatige release.

Voor een routineversie laat ik de automatische release staan. Nolera 1.0.2, goedgekeurd op 12 oktober 2026, verscheen volgens de openbare zoek-API van iTunes minder dan een minuut na de e-mail van Apple in de App Store. Dat is één enkele waarneming: reken ruim.

De gefaseerde release over 7 dagen

De hulp van Apple over gefaseerde releases geeft het exacte schema:

Dag	Aandeel gebruikers
1	1%
2	2%
3	5%
4	10%
5	20%
6	50%
7	100%

De update gaat naar een willekeurige steekproef van gebruikers die automatische updates aan hebben staan, op compatibele apparaten. Ze krijgen niet te horen dat ze erbij horen.

De gefaseerde release remt alleen automatische updates af. Apple geeft aan dat iedereen de nieuwe versie op elk moment uit de App Store kan downloaden. Iemand die je app installeert of op je productpagina op "Update" tikt, kan hem dus al op de eerste dag hebben. Het is geen test op 1% van je gebruikers: het is een rem op de rest.

Om hem aan te zetten open je de versie, scrol je naar de sectie Phased Release for Automatic Updates, vink je "Release update over a 7-day period using phased release" aan en sla je op. Daarvoor heb je de rol Account Holder, Admin of App Manager nodig. De optie blijft beschikbaar tot de status Pending Developer Release: je kunt hem nog aanzetten na de goedkeuring van Apple, zolang de versie op jouw handmatige release wacht.

Zodra de versie is goedgekeurd, staat bij de status Ready for Distribution de vermelding "Phased Release". Aan het eind van de 7 dagen krijgen de Admins en App Managers van de app een melding.

Pauzeren, hervatten en voor iedereen uitbrengen

• Pauzeren: in totaal tot 30 dagen, zo vaak als je wilt. Een pauze van 10 dagen laat 20 dagen over voor de volgende.
• Hervatten: de release gaat verder op de dag waarop je hem had stilgezet.
• Voor iedereen uitbrengen: de knop Release to All Users, rechtsboven in de versie, stuurt de update naar alle apparaten met automatische updates.
• Uit de verkoop halen: dat stopt de release definitief, ook als je lidmaatschap van het developerprogramma verloopt. Komt de app weer in de verkoop, dan is de versie in één keer voor iedereen beschikbaar.

Na het uitbrengen voor iedereen valt er niets meer in te stellen, zegt de tabel met bewerkbare eigenschappen.

Nolera 1.0.2 kwam uit zonder gefaseerde release. Zo zou ik hem in die week gebruiken:

Wat je ziet	Wat je doet	Wat er gebeurt
Crashes of bezorgde reviews	Pauzeren	Automatische updates stoppen
De fix is klaar	Nieuwe versie	Hij gaat opnieuw in review, met zijn eigen release
Niets vreemds na 3 of 4 dagen	Release to All Users	Iedereen krijgt hem
Je wacht op een reactie van Apple	Pauzeren, 30 dagen totaal	Hervatten op de dag waarop je stopte

Tijdens een pauze gaan handmatige downloads gewoon door. Vink de gefaseerde release aan voor elke versie die aan betalingen of de eerste opstart raakt: daar kost een fout het meest, en je kunt niet terug.

Als de fix dringend is: de versnelde review

Apple laat je een versnelde review aanvragen. Die is bedoeld voor echte noodgevallen: een kritieke bug die opgelost moet worden, of een release die aan een evenement gekoppeld is.

1. Dien eerst je versie in. Beschrijf de bug in het veld Notes voor de reviewer.
2. Vul het aanvraagformulier voor een versnelde review in en kies je app en het platform.
3. Apple versnelt de review naargelang de beschikbaarheid. Niets is gegarandeerd.

Gaat het om een evenement, vermeld dan in de notities de datum en jouw band ermee. De gebruikelijke doorlooptijden vind je in hoe lang de App Store-review duurt.

Wat opnieuw in review gaat, en wat niet

Wijziging	Wat je nodig hebt
Native code, permissies, SDK-versie	Nieuwe build, nieuwe versie, volledige review
Screenshots, beschrijving, zoekwoorden, What's New	Een nieuwe versie, samen daarmee gereviewd
Promotietekst	Niets: hij verandert zonder nieuwe indiening
Pauzeren, hervatten, voor iedereen uitbrengen	Niets: dat zijn release-instellingen
Header van de iOS 27-productpagina	Los in Asset Library, of samen met een versie
JavaScript-fix, met Expo	Een update op afstand is mogelijk

De promotietekst verandert zonder nieuwe indiening, volgens de pagina over versie-informatie. Met Expo verandert een update op afstand JavaScript, teksten en afbeeldingen zonder langs de App Store te gaan. De documentatie van Expo noemt twee grenzen: native code, permissies en de SDK-versie vereisen een nieuwe binary, en updates moeten de regels van de App Store volgen.

Mijn geval: een fix op afstand die de reviewer nooit heeft gezien

In september 2026 wachtte een build van Nolera op review. Ik had een fout in het scanscherm opgelost en die fix tijdens het wachten als update op afstand gepubliceerd. De build werd toch afgewezen, vanwege die al opgeloste fout.

De verklaring staat in de documentatie van expo-updates: standaard downloadt de app de update bij het opstarten en past hem toe bij de volgende keer opstarten. De reviewer installeert de app, start hem één keer en test de code die in de build zit. Dezelfde regel geldt voor je nieuwe gebruikers: hun eerste sessie draait op de code van de build.

Sindsdien gaat elke wijziging aan het startscherm, de paywall of de hoofdfunctie in een nieuwe build. De update op afstand is alleen bedoeld voor mensen die de app al hebben.

De beoordeling resetten met een versie

Elke nieuwe versie biedt de optie Reset rating when this version is released. Volgens de hulp van Apple over het resetten geldt die voor alle landen, blijven geschreven reviews staan en kun je hem na de release niet meer terugdraaien. Apple raadt aan er spaarzaam mee om te gaan, omdat een productpagina met weinig beoordelingen mensen kan afschrikken.

De checklist voordat je je update indient

• Het versienummer is hoger, de build is opgehoogd.
• De build is getest in TestFlight, op een kleine iPhone en op iPad als je app daarop draait.
• What's New is in elke taal geschreven en belangrijke wijzigingen staan erin.
• De screenshots tonen de huidige interface als die is veranderd.
• De notities voor de reviewer zeggen wat er is veranderd en waar je het vindt.
• De release-optie is gekozen: handmatig als je een datum moet halen.
• De gefaseerde release is aangevinkt als de versie aan betalingen of de eerste opstart raakt.
• Je weet of een eventuele fix op afstand kan, of een nieuwe build vraagt.

Bij elke update door de review komen

Elke update gaat opnieuw langs App Review, en een afwijzing blokkeert je fix. De Review Kit bundelt mijn checklist voor het indienen, mijn opgeloste afwijzingen en twee Claude Code-skills die je project en je productpagina nalopen en je antwoord voorbereiden als Apple afwijst. Het complete traject staat op de pagina een app publiceren in de App Store.

Bereid je je eerste release voor? Doe je gratis diagnose: die zet de stappen op volgorde en stuurt je mijn checklist tegen afwijzingen door Apple.

Veelgestelde vragen

Hoe lang duurt een gefaseerde release in de App Store?

Zeven dagen: 1% van de gebruikers met automatische updates op de eerste dag, daarna 2, 5, 10, 20 en 50%, en 100% op de zevende. Je kunt hem in totaal tot 30 dagen pauzeren, of op elk moment afronden met Release to All Users.

Gaat een update van een iOS-app opnieuw door de review van Apple?

Ja. Elke nieuwe versie, met zijn build en metadata, gaat door App Review. De promotietekst en de release-instellingen pas je aan zonder nieuwe indiening.

Kun je in de App Store terug naar een oudere versie van een app?

Nee. Je moet een nieuwe versie maken met de fix en die ter review indienen. Daarom zijn de gefaseerde release en de pauzeknop zo handig.

Krijgen nieuwe gebruikers de update tijdens een gefaseerde release?

Ja, als ze de app uit de App Store downloaden. De gefaseerde release regelt alleen automatische updates: iedereen kan de nieuwe versie op elk moment downloaden.

Kun je de gefaseerde release aanzetten na de goedkeuring van Apple?

Ja, zolang de versie de status Pending Developer Release heeft, dus bij een handmatige release die nog niet is gepubliceerd. Is de versie eenmaal uit, dan is het voor die versie te laat.

Wat zet je in de release notes van een update?

Nieuwe functies en belangrijke wijzigingen, duidelijk opgesomd: dat is regel 2.3.12. Voor een gewone bugfix of een beveiligings- of prestatiefix volstaat een algemene formulering. Het veld accepteert 4.000 tekens en vertaal je in elke taal.