appeventor.com

How to create an in-app event in App Store Connect

Checked against App Store Connect Help on 7 November 2026. Apple renames buttons from time to time, so if a label differs, the linked help page has the current one.

An in-app event takes five steps in App Store Connect: create it, describe it, schedule it, add the details, and submit it for review. This guide walks through each step with the limits Apple publishes, so nothing in the form surprises you.

Before you start

Have these ready, because the form asks for all of them:

Step 1: Create the event

  1. Open your app in App Store Connect and click In-App Events in the left sidebar.
  2. Click Create In-App Event, or the add button (+).
  3. Enter a reference name. Only you see it, in App Store Connect. It must be unique and can be up to 64 characters.
  4. Click Create.

Step 2: Describe the event

  1. Event name, up to 30 characters. This is what people see on the App Store and in Apple Games.
  2. Short description, up to 50 characters, shown on the event card.
  3. Long description, up to 120 characters, shown on the details page.
  4. Media for the event card and the details page. You can upload files, or pick approved images and videos from your Asset Library with Browse Assets.
  5. Badge: the type of event, shown above the name. See our badge guide.
  6. Localizations, if you want the event in more languages. Choose the primary language to open the language menu.

Apple has style rules for these fields, such as title case for the name and no specific prices in the text. They are collected in our in-app event guidelines page.

Step 3: Choose where and when

Scroll to Country or Region Availability. By default, an event is set to show in every storefront, but it only shows where your app is available.

Click Save at the top right.

Step 4: Add the details

Step 5: Submit it for review

Events need App Review approval before anyone can see them. How you submit depends on your app:

  1. Open the event and click Add for Review at the top right.
  2. Add it to an existing draft submission or create a new one. The status becomes Ready for Review.
  3. If you're submitting without an app version, choose a platform. The event is then reviewed together with the latest version of that platform.
  4. Click Submit for Review. The status becomes Waiting for Review, then In Review once review starts.

Users with the Marketing role can submit events but can't add app versions to a submission.

Event statuses

StatusWhat it means
DraftsCreated but not submitted. Up to 50 at a time.
In ReviewApp Review is looking at it.
RejectedApp Review turned it down.
Approved, Set to PublishApproved, and waiting for the publish date you chose.
Approved, PublishedApproved and visible on the App Store and in Apple Games.
PastThe event has ended.

Changing an event later

Media specifications

MediaRatioSmallestLargestFiles
Event card image16:91920×10803840×2160JPG, JPEG, PNG
Event details image9:161080×19202160×3840JPG, JPEG, PNG
Event card video16:91920×10803840×2160MOV, M4V, MP4
Event details video9:161080×19202160×3840MOV, M4V, MP4

Videos run at 30 or 60 frames per second, and every file can be up to 500 MB. Video audio is stereo at 44.1 or 48 kHz. Card videos use 256 kbps AAC, details page videos use PCM or 256 kbps AAC, and videos without sound are fine.

Apple crops event media and adds its own gradients, and App Store Connect's preview is there so you can check that nothing important is hidden. In our own measurements of the event card, the lower part and the top-right corner get covered. Before uploading, you can see this on your image with our free safe area checker.

Doing it in bulk

If you run many events, Apple lets you create them and upload their metadata through the App Store Connect API, including submitting them for review.

After it goes live

In the Analytics tab, under Acquisition, the In-App Events section shows impressions, details page views, app opens, reminders, notification taps and downloads for each event. An event's data appears once it has brought at least 5 first-time downloads. Our guide on getting downloads from events covers what to watch.

An approved or published event can also be attached to a Featuring Nomination, which is how you tell Apple's editors about it. See how to get your event featured.

Sources

  1. Overview of In-App Events, App Store Connect Help
  2. Offer In-App Events, App Store Connect Help
  3. Submit an In-App Event, App Store Connect Help
  4. Manage events, App Store Connect Help
  5. In-App Event statuses, App Store Connect Help
  6. In-App Event media and audio specifications, App Store Connect Help
  7. Nominate your app for featuring, App Store Connect Help
  8. In-App Events analytics, App Store Connect Analytics Help
  9. In-App Events, Apple Developer

More guides

All guides · Free safe area checker

Make my event images