Shotlingo shotlingo
Compiled from App Store Connect Help on 2026-10-31

App Store In-App Event Specs 2026

Every text limit and media size for an App Store in-app event, the 7 event types, and the scheduling rules. Click any value to copy. Free, no signup.

Text limits and media sizes

FieldLimitRequiredNote
Event reference name
 Yes
Internal only. Never shown on the App Store.
Event name
 Yes
Shown on the event card and details page. Localizable.
Short description
 Yes
Shown on the event card. Localizable.
Long description
 Yes
Shown on the event details page. Localizable.
Event card image
 Yes
JPG or PNG, landscape, up to 500 MB.
Event details page image
 Yes
JPG or PNG, portrait, up to 500 MB.
Event card video
 Optional
MOV, M4V or MP4, up to 500 MB. Videos autoplay and repeat, so make the clip loop.
Event details page video
 Optional
MOV, M4V or MP4, portrait, up to 500 MB.
Deep link
 Optional
Opens the event inside your app from Open on the card or details page. A universal link (Apple recommends it) or a custom URL.

Event types

TypeUse it for
Goal-based activity users complete over time, such as a streak or fitness month.
Players or teams compete for rank, such as a tournament or leaderboard season.
Something that happens at a set time, such as a stream, concert or in-game happening.
A large release with new features or content, not a routine bug fix.
A new season, chapter or content cycle, such as a battle pass reset.
First availability of new content, such as a show, album, level pack or collection.
Anything that does not fit above, such as a sale, collaboration or holiday theme.

Scheduling and review rules

RuleValueNote
Event duration
An event can be promoted on the App Store up to 14 days before its start date.
Published at once
Per app, on the App Store at a time.
Approved at once
Per app, in App Store Connect at a time.
Review
Every event goes through App Review. Apple says specific pricing in the event leads to rejection.
Event priority
Events show on the product page by start time, soonest first. High priority events show ahead of normal ones.
Event purpose
Appropriate for all users, attract new users, keep active users informed, or bring back lapsed users. Not shown to users; it feeds personalized recommendations.
Localization
Name, short and long description are localized per language. The primary language shows where the event has no localization.
Where events appear
In search the event card shows to users who already downloaded the app. Events also appear in Apple Games.

Download the dataset

Use the JSON in your release checklist or CI; the CSV opens in any spreadsheet.

JSON
app-store-in-app-event-specs.json
Machine-readable. Every field, event type and rule.
CSV
app-store-in-app-event-specs.csv
Spreadsheet-friendly. One row per field.

Embed this reference on your site

Drop the iframe below into any ASO guide or internal wiki. It auto-themes to light/dark.

In-app event specs table 
<iframe
  src="https://shotlingo.com/tools/app-store-in-app-event-specs/embed"
  width="100%"
  height="440"
  style="border:0;border-radius:14px;max-width:960px"
  loading="lazy"
  title="App Store in-app event specs 2026 (Shotlingo)"></iframe>

Localize the event art.

Shotlingo translates your App Store screenshots into 40+ languages and exports at every required size, so each storefront shows an event card that reads natively.

Start free Character limits →

Frequently Asked Questions

What are the character limits for App Store in-app events?

The event name is 30 characters, the short description is 50 characters and the long description is 120 characters. The reference name is internal and is not shown to users.

What image size do in-app events need?

The event card image is landscape 16:9, from 1920 x 1080 up to 3840 x 2160 pixels. The event details page image is portrait 9:16, from 1080 x 1920 up to 2160 x 3840 pixels. Both take JPG or PNG up to 500 MB.

How long can an in-app event run?

Up to 31 days from start to end. It can be promoted on the App Store up to 14 days before it starts.

How many in-app events can an app have?

Up to 10 can be published on the App Store at once and up to 15 can be approved in App Store Connect at once.

Can I localize an in-app event?

Yes. The name, short description and long description are localized per language. Users whose language the event does not cover see the primary language.

Do in-app events need App Review?

Yes. Every event is reviewed before it can go live. You can submit an event apart from a new app version, so submit it with enough lead time before the start date.

Sources & Changelog

Sourced from App Store Connect Help and the in-app events overview. Maintained independently. Apple changes limits without notice, so confirm a number in App Store Connect before you rely on it. Related: screenshot sizes and character limits.