appeventor.com

App Store in-app event guidelines

Checked against Apple's documentation on 7 November 2026. The Apple pages behind each section are linked in the text and listed under Sources at the end, so you can check them when Apple updates its pages.

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:

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:

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

Short and long descriptions

FieldLimitWhere it showsCase
Short description50 charactersThe event card, for example on the Today tab and in searchSentence case
Long description120 charactersThe event details page, after someone taps the cardSentence case
Reference name64 charactersOnly in App Store Connect, never on the storeAny

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

(In-App Events)

Image and video rules

The event card is landscape and the details page is portrait. These are the sizes in Apple's media specifications:

MediaRatioSmallestLargestFiles
Event card image16:91920×10803840×2160JPG, JPEG, PNG
Event details image9:161080×19202160×3840JPG, JPEG, PNG
Event card video16:91920×1080, 30 or 60 fps3840×2160, 30 or 60 fpsMOV, M4V, MP4
Event details video9:161080×1920, 30 or 60 fps2160×3840, 30 or 60 fpsMOV, 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:

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:

Timing rules

From Offer In-App Events, unless another link is given:

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

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:

  1. A specific price anywhere in the event text.
  2. Text that describes the app in general instead of this event.
  3. 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.
  4. Dates or times that don't match what happens in the app in some storefront.
  5. 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

Sources

  1. App Review Guidelines, 2.3.13, Apple
  2. In-App Events, Apple Developer
  3. Offer In-App Events, App Store Connect Help
  4. Manage events, App Store Connect Help
  5. In-App Event media and audio specifications, App Store Connect Help
  6. In-App Event badges, App Store Connect Help
  7. In-App Event statuses, App Store Connect Help

More guides

All guides · Free safe area checker

Make my event images