App Store in-app event guidelines
Every in-app event goes through App Review before it appears on the App Store. Many of Apple's rules are about details that have nothing to do with the app itself: no specific prices in the text, the event's real name instead of a slogan, and a deep link that opens the right screen. Below are Apple's published rules, grouped by the part of the event form they apply to.
The review guideline behind it all
Events are covered by guideline 2.3.13 of the App Review Guidelines. In plain words, it says five things:
- An event must be a timely event inside your app, and it must fit one of the event types App Store Connect offers.
- All event metadata must be accurate and describe the event itself, not your app in general.
- The event must really take place on the dates and at the times you set, in every storefront where it shows.
- You can charge for an event, as long as you follow the business rules in section 3 of the guidelines.
- The event's deep link must open the right place in your app.
Most of the rest of this page is Apple's more detailed guidance, from its In-App Events page and App Store Connect Help. Where we add our own advice, we say so.
What counts as an event
Apple's in-app events page names challenges, competitions and special content launches as good candidates. It also lists three things that are not good candidates:
- Repeating activities, such as daily tasks or daily rewards.
- Price promotions that don't add any new content, features or goods.
- General promotions that only raise awareness of your app or game.
Apple allows an event to point at something permanent, like a new feature that stays after the event. But it says the event itself should focus on a related moment or experience that is limited in time.
A quick test we use: can you say what is new, and when it ends? If the honest answer is "nothing new" or "it never ends", Apple is unlikely to see it as an event.
Pick the badge that matches
Every event carries one badge above its name: Challenge, Competition, Live Event, Major Update, New Season, Premiere or Special Event. Because guideline 2.3.13 requires the event to fit one of these types, the badge matters. Apple describes each one on its badge reference page, and our badge guide explains how to choose.
Event name: up to 30 characters
- Up to 30 characters, written in title case.
- Use the real name of the event. Apple's own example of a good name is "June Leaderboard Climb". A call to action like "Watch the livestream" is the kind of name it tells you to avoid.
- Skip generic words, and don't describe the type of event. The badge already says "Challenge" or "Live Event", so repeating it wastes characters.
Short and long descriptions
| Field | Limit | Where it shows | Case |
|---|---|---|---|
| Short description | 50 characters | The event card, for example on the Today tab and in search | Sentence case |
| Long description | 120 characters | The event details page, after someone taps the card | Sentence case |
| Reference name | 64 characters | Only in App Store Connect, never on the store | Any |
Apple suggests the long description as the place for details such as rewards. Both descriptions should describe the event experience, not promote your app or its services. (In-App Events, Offer In-App Events)
Rules for all event text
- Use normal capitalization and punctuation. No all caps, and no strings of exclamation marks.
- Leave out claims nobody can check, such as "the best" or "#1", and filler words such as "game event".
- Don't put specific prices in the text. Prices and currencies differ by region and can change separately from the event, and Apple says outright that specific prices lead to rejection.
Image and video rules
The event card is landscape and the details page is portrait. These are the sizes in Apple's 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, 30 or 60 fps | 3840×2160, 30 or 60 fps | MOV, M4V, MP4 |
| Event details video | 9:16 | 1080×1920, 30 or 60 fps | 2160×3840, 30 or 60 fps | MOV, M4V, MP4 |
Each file can be up to 500 MB. Apple's guidance for what goes in the picture, from its In-App Events page:
- Avoid text and logos when you can, especially your event name or app name. (Our note: the event card already shows your event name and short description with the image, so text in the picture repeats them.)
- Don't add borders or gradients. Apple applies its own crops and gradients so all events look consistent.
- Keep the card and the details page visually connected, for example with similar colors or illustration styles.
- Only use material you made or have a license to use.
- Videos play automatically and repeat, so make the loop seamless.
App Store Connect shows a preview of how your media will look on the card and details page. Use it to make sure nothing important is hidden. You can also check an image before uploading with our free safe area checker, which runs in your browser. Our image size guide has more on sizes.
Deep link rules
The deep link decides where people land when they tap Open on your event. Apple's guidance, from its In-App Events page and App Store Connect Help:
- Use a universal link, which Apple recommends for security, or a custom URL.
- Avoid URL shorteners and other services that add unnecessary redirects.
- Test the link before you submit. Apple suggests pasting it into the Notes app and tapping it.
- Choose the destination with care. If the event is live, link straight to it. If it hasn't started, a landing page that builds anticipation and says when to come back works. New users may need your onboarding first. Always leave a way back to the main app.
Timing rules
From Offer In-App Events, unless another link is given:
- An event can last up to 31 days, and must last at least 15 minutes.
- It can appear on the App Store up to 14 days before it starts. You set this with the publish date.
- You can start the event at different times in different countries or regions, but all start dates must fall within 48 hours of each other.
- Whatever times you set, the event has to actually run at those times. That is part of guideline 2.3.13.
- Once an event is published, you can only change its start and end dates. After it starts, only the end date. (Manage events)
Events that cost money
Paid events are allowed under section 3 of the guidelines. In the form, say whether an In-App Purchase is needed to take part, because the details page shows it. Subscription apps only need to mark this when the event costs extra on top of the subscription, such as a pay-per-view event. (2.3.13, Offer In-App Events)
Settings that affect reach, and the limits
- Purpose. You choose between appropriate for all users, attract new users, keep active users informed, and bring back lapsed users. Apple uses this as one factor in personalized recommendations. It isn't shown on the event card or details page, and every published event can still be found by everyone.
- Priority. Events on your product page are sorted by start time, soonest first. Events marked high priority come before normal ones.
- Limits. Up to 10 events published at once, 15 approved events per app, 50 drafts, and 10 events with overlapping start dates and times, counting drafts. (Offer In-App Events, statuses)
Where events tend to go wrong
Apple doesn't publish rejection statistics, so we can't tell you which reason is most common. These are the points Apple states as rules, in guideline 2.3.13 or with the word "rejection", which makes them the ones to check twice:
- A specific price anywhere in the event text.
- Text that describes the app in general instead of this event.
- An event that doesn't fit any of the event types in App Store Connect. Our tip: Apple's list of poor candidates, such as daily rewards or a sale with nothing new, is a good warning sign.
- Dates or times that don't match what happens in the app in some storefront.
- A deep link that doesn't open the right place in the app.
Apple's media advice (avoid text, consider video, keep the card and details art consistent) and its advice against URL shorteners are guidance. Its pages don't say that breaking them causes a rejection on its own.
Checklist before you submit
- The name is the event's real name, in title case, at most 30 characters.
- The descriptions describe this event, in sentence case, with no specific prices and no "#1".
- The badge matches what the event really is.
- The card is 16:9 and the details image 9:16, with no borders, no added gradients, and no text where you can avoid it.
- The deep link opens the event, preferably as a universal link as Apple recommends, and you tested it on a phone.
- Dates, times and regions match what will happen in the app.
- If the event needs a purchase, the form says so.
Sources
- App Review Guidelines, 2.3.13, Apple
- In-App Events, Apple Developer
- Offer In-App Events, App Store Connect Help
- Manage events, App Store Connect Help
- In-App Event media and audio specifications, App Store Connect Help
- In-App Event badges, App Store Connect Help
- In-App Event statuses, App Store Connect Help