How to create an in-app event in App Store Connect
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
- Your role. You need to be the Account Holder, an Admin, an App Manager or in Marketing.
- Your platform. Events show on iPhone and iPad, on iOS 15 and iPadOS 15 or later. Apple's featuring help notes that In-App Events are only available for iPhone and iPad apps.
- The limits. An app can have up to 10 events published on the store at once and up to 15 approved events in App Store Connect. You can keep up to 50 drafts. Up to 10 events can have overlapping start dates and times, counting approved events and drafts.
Have these ready, because the form asks for all of them:
- A name of up to 30 characters, a short description of up to 50 and a long description of up to 120.
- A landscape image or video for the event card and a portrait one for the details page.
- A deep link that opens the event inside your app.
- Start and end dates and times, and the day you want the event to appear.
Step 1: Create the event
- Open your app in App Store Connect and click In-App Events in the left sidebar.
- Click Create In-App Event, or the add button (+).
- Enter a reference name. Only you see it, in App Store Connect. It must be unique and can be up to 64 characters.
- Click Create.
Step 2: Describe the event
- Event name, up to 30 characters. This is what people see on the App Store and in Apple Games.
- Short description, up to 50 characters, shown on the event card.
- Long description, up to 120 characters, shown on the details page.
- 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.
- Badge: the type of event, shown above the name. See our badge guide.
- 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.
- Start and end. The start can be any future date. The end can be at most 31 days after the start, and an event must last at least 15 minutes.
- Publish date. This is when the event becomes visible on the store. It can be up to 14 days before the start, which gives people time to tap the button that notifies them when it begins.
- Different start times per region. Click Customize Dates and Times, pick the countries or regions, and set their start. A time zone toggle sits at the top right. All start dates must fall within 48 hours of each other.
Click Save at the top right.
Step 4: Add the details
- Event deep link. Where people go when they tap Open on the card or details page. Apple recommends a universal link for security, though a custom URL works. Avoid URL shorteners and other unnecessary redirects, and test the link, for example by pasting it into Notes and tapping it.
- Purpose. Appropriate for all users, attract new users, keep active users informed, or bring back lapsed users. The App Store uses it to help reach the right people. It isn't shown on the event.
- Priority. Your product page lists events by start time, soonest first. High priority events go ahead of normal ones.
- In-App Purchase required. Indicate whether an In-App Purchase is needed to take part, because the details page shows it. A subscription app only needs to tick it when the event costs extra on top of the subscription.
- Primary language. The language people see when the event isn't localized for their device.
Step 5: Submit it for review
Events need App Review approval before anyone can see them. How you submit depends on your app:
- App not approved yet: include the event in the same submission as your first iOS app version.
- App already approved: submit the event on its own, or together with a new app version.
- Open the event and click Add for Review at the top right.
- Add it to an existing draft submission or create a new one. The status becomes Ready for Review.
- If you're submitting without an app version, choose a platform. The event is then reviewed together with the latest version of that platform.
- 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
| Status | What it means |
|---|---|
| Drafts | Created but not submitted. Up to 50 at a time. |
| In Review | App Review is looking at it. |
| Rejected | App Review turned it down. |
| Approved, Set to Publish | Approved, and waiting for the publish date you chose. |
| Approved, Published | Approved and visible on the App Store and in Apple Games. |
| Past | The event has ended. |
Changing an event later
- Approved, not yet published: you can change availability, priority, start, end and publish date, as long as those dates are still in the future.
- Waiting for Review or In Review: remove it from review first. Only country or region availability can be changed without doing that.
- Published: only the start and end dates. The 14-day and 31-day rules still apply.
- Started: only the end date.
- Ended: you can archive it from Past Events.
- Deleting: possible for events in Draft, Archived or Approved state. A deleted event is gone for good.
Media specifications
| Media | Ratio | Smallest | Largest | Files |
|---|---|---|---|---|
| Event card image | 16:9 | 1920×1080 | 3840×2160 | JPG, JPEG, PNG |
| Event details image | 9:16 | 1080×1920 | 2160×3840 | JPG, JPEG, PNG |
| Event card video | 16:9 | 1920×1080 | 3840×2160 | MOV, M4V, MP4 |
| Event details video | 9:16 | 1080×1920 | 2160×3840 | MOV, 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
- Overview of In-App Events, App Store Connect Help
- Offer In-App Events, App Store Connect Help
- Submit an In-App Event, App Store Connect Help
- Manage events, App Store Connect Help
- In-App Event statuses, App Store Connect Help
- In-App Event media and audio specifications, App Store Connect Help
- Nominate your app for featuring, App Store Connect Help
- In-App Events analytics, App Store Connect Analytics Help
- In-App Events, Apple Developer