How to Update Your App's App Store Listing

A step-by-step guide on how to update your iOS app's description, change screenshots and more.

Updated on 10. March 2025 by Jan Bunk

App store metadata and preview cards being edited before a listing update is published.
You are not logged in. This guide can only be completed if you have converted your website into an app with webtoapp.design.
This guide is part of the app publishing process. You should only complete it when asked to in the app publishing timeline.
Open the App Store Connect app overview.

Select your app.

Take note of the current version of your app (highlighted in the following screenshot). Afterwards, click the plus button in the menu on the left.

A screenshot highlighting the current version number and the add version button in App Store Connect.

In the dialog that opens, enter a new version number that is higher than the last one. For example if your previous version number was 2.0 you can now enter 2.1 or 3.0. Afterwards, click "Create".

New Version dialog with the Store Version Number field and Create button.

Mandatory Fields to Update

Scroll down a bit and fill out the "What's New in This Version" field with a bit of information about what's new in this app update.

What's New in This Version field with example release notes.

Scroll down further to the "App Review" section.

If your website has an account system, you need to provide a test account to the app reviewers so they can access and test all parts of your app.

  • A test account is necessary even if just a small part of your app/website requires logging in.
  • The test account credentials must work to log in on your website. It's not your webtoapp.design, Google or Apple account details.
  • The test account doesn't need to have any special admin permissions. Just a regular user account for your website.
  • The test account should have a username and password consisting only of letters and numbers that are easy to type. If you include special characters like "*", the app reviewers might not be able to log in.
Please double-check that the test account you provided works. If the app reviewers can't log in with it, your app will be rejected.

A screenshot of the filled out test login details fields.

In case you see a message saying you still need to upload a build, that's completely normal. We will upload and select a build in the following guides.

A screenshot of the message "Upload your build using one of several tools" in App Store Connect.

Optional Fields to Update

If you'd like, you can change fields like "Promotional Text", "Keywords", "Support URL", "Marketing URL" and "Description".

You can also make changes to your screenshots, you don't have to though.