App Store in-app events: promote what's happening in your app
Short answer: In-app events are time-limited happenings inside your app (a challenge, a premiere, a live session) that Apple shows as event cards on your App Store product page, in search and in editorial spots. You set them up in App Store Connect with a badge, a name of up to 30 characters, a short description of up to 50, a long description of up to 120, an image or video, dates and a deep link, and each event is reviewed separately from app updates. Google Play has a similar feature called promotional content, with its own durations, approval time and eligibility rules.
For a small business app, events are one of the few ways to get fresh visibility on the store without shipping a new version. They work best when something genuinely new is happening, and Apple's guidelines are strict about what counts.
What an in-app event is
Apple's in-app events page describes them as timely events within apps and games, such as competitions, premieres and livestreamed experiences. They appear as event cards with an image or video, the event name and a short description. Tapping opens an event details page with a longer description, a note if an in-app purchase or subscription is needed, sharing options, and a way to opt in to a notification when the event starts.
Where they appear
- On your product page, which shows all currently published events.
- In search results: the event card shows alongside your app for people who have it installed, while people who don't have it see screenshots. People can also search for events directly.
- In editorial selections and personalised recommendations on the Today, Games and Apps tabs.
People without your app can download it from the event card, then tap Open to go straight to the event.
What makes a good event
Apple suggests challenges, competitions and special content launches. It lists poor candidates too: repetitive activities like daily tasks or rewards, price promotions that add no new content, and general promotions raising awareness of the app. An event can highlight permanent new content, but the event itself should be a limited-time moment.
How it works: badges, metadata and timing
Choose a badge
The badge sits above the event title. Apple's options are Challenge, Competition, Live Event, Major Update, New Season, Premiere and Special Event. Pick the one that describes the activity; the badge already says the type, so the name shouldn't repeat it.
Write the metadata
| Field | Limit and style (Apple) | Where it shows |
|---|---|---|
| Reference name | Internal only | App Store Connect |
| Event name | Up to 30 characters, title case, the actual name of the event, not a call to action | Event card and details page |
| Short description | Up to 50 characters, sentence case | Event card |
| Long description | Up to 120 characters, sentence case | Event details page |
| Media | Image or video for card and details page; videos autoplay and loop | Both |
Apple's guidance also says: no all-caps or repeated exclamation marks, no unverifiable claims such as "the best", no specific prices (pricing in metadata leads to rejection), and avoid text or logos in the media.
Set the dates and reach
- An event can last up to 31 days.
- It can be promoted up to 14 days before it starts, and you choose when it appears on the store.
- You can limit it to specific regions with different dates per region.
- An app can have up to 10 events published at a time, and up to 15 approved events in App Store Connect.
- Events are submitted for review independently of app versions.
Add a deep link
The deep link decides where "Open" takes people. Apple recommends a universal link over a custom URL, warns against URL shorteners and extra redirects, and suggests testing by pasting the link into the Notes app and tapping it. Think about state: before the event starts, link to a page that builds anticipation; for brand-new users, run onboarding first; always give a route back to the main app.
Pick the purpose
You choose who the event is mainly for: all users, new users, active users or lapsed users. Apple says this is one of the factors used for personalised recommendations and doesn't appear on the card.
A filled-in example
A hypothetical example for a UK yoga studio's booking app running a spring challenge:
| Field | Entry |
|---|---|
| Reference name | 2027-03 spring challenge UK |
| Badge | Challenge |
| Event name | Spring Mobility Challenge (25 characters) |
| Short description | Ten minutes a day to loosen up before summer (44) |
| Long description | Follow a short guided session each day for three weeks and track your streak in the app (87) |
| Media | Short looping video of a stretch sequence, no text overlay |
| Dates | 21-day event, shown on the store 7 days before the start |
| Regions | United Kingdom |
| Deep link | Universal link to the challenge screen, with a pre-start landing page |
| Purpose | Bring back lapsed users |
Note what isn't there: no price, no "best yoga app", no "Join now!" as a name.
The Google Play equivalent: promotional content
Google Play calls this promotional content. The main points from Play Console Help:
- Available to all games, and to apps that meet Google's eligibility criteria for Premium growth tools. Featuring, deep links and audience targeting also depend on that eligibility.
- Created under Grow users → Store presence → Promotional content.
- Events can run for up to four weeks. Major updates have a set duration of 28 days and pre-registration announcements one week.
- Submission is possible from 60 days before the start date, and approval can take up to four days, so Google recommends submitting at least four days ahead.
- A preview can show the event up to 14 days before it starts so people can ask to be notified; offers can't be previewed.
So a small, non-game app may not qualify on Play. Check eligibility in your Play Console before planning a cross-store campaign.
Planning tips for small teams
- Plan two or three events a year around things that genuinely happen: a seasonal programme, a new feature, a live session.
- Build the in-app destination before the event card.
- Submit Apple events well ahead of the promotion window, and Play content at least four days before the start.
- Share the event details page link in your email and social posts, as Apple suggests.
- After the event, compare downloads and re-engagement during the event window with a normal period.
FAQ
Do I need a new app version to run an event?
Not for Apple: events are submitted for review on their own. The event content itself must already exist in the live app.
Can I use an event to promote a sale?
Not a plain discount. Apple lists price promotions without new content as poor candidates, and specific prices in metadata lead to rejection.
Will an event get my app featured?
Not automatically. Apple says you can share events with its editors for consideration; selection is up to them.
Are events only for games?
No. Apple's examples include fitness challenges and premieres, and booking, learning or media apps can run them when something time-limited is happening.
When your app has a programme or launch coming up and the store listing doesn't reflect it, we can plan the event card and the in-app landing screen together.