After the upload
When the Ship to TestFlight card shows ”✓ Uploaded to TestFlight”, press Open App Store Connect. The card also reminds you that Apple may still be processing the build. Then:1
Wait for Apple to process the build
Apple processes each new build before anyone can install it. Check the build’s status in App Store Connect.
2
Add testers
In the app’s TestFlight section, add internal testers from your App Store Connect team, or create an external group and invite people by email. Apple reviews a build before external testers can install it. Testers install your app with Apple’s TestFlight app on their iPhone.
3
Complete your App Store listing
Most of the listing text (description, keywords, promotional text, support and marketing URLs, category, copyright) can be filled in from the Deploy tab’s App Store readiness checklist, which saves straight to App Store Connect. Age rating and App Privacy details are still set in App Store Connect itself.
4
Tell App Review about your app
Fill in the App Review Notes and the App Review Contact and Sign-in rows of the same checklist before you submit. See What Apple asks a new developer account.
5
Submit for review
Choose the build for your version and submit it for review in App Store Connect. Apple reviews the app, and the result shows in App Store Connect.
What Apple asks a new developer account
Apple often sends back a first submission from a new developer account with a message titled “Guideline 2.1 - Information Needed”. It is a request for information, not a fault in your app. The Deploy tab’s App Store readiness checklist has a row for each thing Apple asks for, and each one saves straight to App Store Connect:- App Review Notes. What the app is for, how to reach each main feature, the services it relies on, and whether anything differs by region. Press Ask Newly to write it for a draft, which is a normal Newly Agent turn.
- App Review Contact and Sign-in. A name, an email and a phone number that starts with + and its country code. Apple won’t save your notes without them. Say whether reviewers have to sign in, and if they do, give them a demo account that never expires. Apple keeps the password. Newly doesn’t store it.
- Screen Recording for App Review. A recording of your app on your own iPhone. Apple asks for it in that message, so nothing requires it before you submit, but you can add it up front. A simulator recording isn’t what Apple asks for.
1
Install the build on your iPhone
Install it from TestFlight, and update the iPhone to the latest iOS.
2
Start recording, then open the app
Start a screen recording from Control Center, then open the app from the Home Screen. The recording has to begin with the app launching.
3
Use the app like a new user
Go through the first screens and each main feature. If your app has accounts, show signing up, signing in and deleting the account. If people can post or message, show reporting a post and blocking a user. If anything is paid, open the paywall and show what it unlocks.
4
Add it in the Deploy tab
Open the Screen Recording for App Review row and press Add recording. It takes an .mp4 or .mov up to 500 MB and uploads it to App Store Connect. Apple keeps one file, so make it a single recording. To swap it, remove the one that’s there first. Open app.newly.app on your iPhone to pick the recording straight from Photos.
How the agent can help
The agent can’t press buttons in App Store Connect for you, but it can help you get ready:- Readiness checklist. Ask “check if my app is ready for the App Store”. The agent checks your project against a store readiness checklist and shows the results in the chat, such as a missing app description, privacy policy URL, screenshots, permission descriptions or encryption compliance. You still set the age rating and App Privacy details yourself in App Store Connect.
- Listing copy. Ask for an app description, subtitle, promotional text or keywords, then paste the result into the matching field on the Deploy tab’s readiness checklist, which saves it straight to App Store Connect.
- Rejections. If Apple rejects your app, Newly asks to read Apple’s message the next time you open the project, or you can paste the message into the chat. The agent can explain it and change your code to address it. Then upload a new build and reply to Apple in App Store Connect.
Screenshots for your listing
- In the Deploy tab: open Deploy, pick the App Store or Google Play, and open App Store Screenshots or Play Screenshots in the readiness review. It shows what the store holds now. Add PNG or JPEG images (each App Store screenshot goes into the device size it fits), put App Store screenshots in order, or remove one. Google Play’s Feature Graphic row does the same for the 1024 x 500 feature graphic and the 512 x 512 store icon, one of each, where adding a new one replaces the old. Ask Newly to make them has the agent capture your real app and save the images in your project, and you add them from the same place. Adding, ordering and removing are free; asking the agent is a normal turn.
- From the cloud simulator: open your app in the cloud simulator, go to the screen you want, hover over the simulator to show its controls, and press Save screenshot to Downloads (the camera button). See Using the cloud simulators.
- In Local chats (Mac): the agent can make styled store screenshot sets. AI-generated backgrounds need your own OpenAI API key; without one, the sets use a plain gradient. See Local chats on your Mac.
Google Play
The Deploy tab has an Android section for publishing to Google Play. An organization owner or admin connects their Google Play account (their own Google Cloud project and Play Console) and picks or creates the app there. Once that’s done, one press builds, signs and uploads the app to Google Play internal testing. From there you can edit the Play listing, run a readiness check and release to production. Google asks new personal Play Console accounts to run a closed test first, with at least 12 testers who stay opted in for 14 days, before it allows a production release. Organization accounts skip this. In a Remote chat, you can also ask the agent to “publish to Google Play”. This opens a card that either sends your latest saved version to internal testing, or names the setup step you still need to finish. Members can see the card, but only an owner or admin can set up Google Play or send a build. Newly also builds a standalone release APK you can download and install on a phone, separately from Google Play: ask the agent for one. See Download an Android APK. You can also test the Android version on the Android cloud simulator (“Pixel 8 - Android”).Android signing keys you created in Newly v1 (legacy) stay with your Newly v1 project. Newly v1 and v2 are separate, and your v1 keys don’t move into v2. To check which product a project is in, see v1 vs v2: which one am I using?.
Related
Ship your iOS app to TestFlight
Build and upload a new version.
App name, icon, bundle ID and version
Bump the version before your next release.
Testing on a real phone
Install your app on your iPhone.
Getting help
Contact support from the app.