Offer in-app events

Offer in-app events

You can have up to ten approved in-app events per app in App Store Connect, and you can publish a total of five per app at a time on the App Store, regardless of country or region.

Learn how to create a high-quality event.

Learn how to create in-app event using the App Store Connect API.

Required role: Account Holder, Admin, App Manager, or Marketing. View role permissions.

Create an in-app event

  1. In the left sidebar, click In-App Events.

  2. Click Create In-App Event or click the add button (+).

  3. Enter a reference name. This name identifies your event in App Store Connect and is not visible on the App Store. Each name must be unique and can be up to 64 characters long.

  4. Click Create.

Enter event information

  1. In the left sidebar, click In-App Events.

  2. Select your event from the list.

  3. Enter an event name to appear on the App Store. It can be up to 30 characters.

  4. Enter a short description to appear on your event card in places like the Today tab and Search on the App Store. It can be up to 50 characters.

  5. Enter a long description that will appear on your event details page when users tap your event card. It can be up to 120 characters.

  6. Upload media for your event card and event details page. Learn about thein-app event media specifications.

  7. Choose a badge that best fits the type of event you’re offering to display above the title on the event card and event details page.

  8. Add localizations for your event by choosing the primary language to display the language pop-up menu. Learn about localizing app information.

Select country or region availability

The Country or Region Availability setting controls where your event appears on the App Store. The default selection will be all storefronts, but please note that your event’s availability will be determined by your app’s availability. You can select the date and time your event first becomes discoverable to users, as well as the date and time the event starts and ends.

  1. In the left sidebar, click In-App Events.

  2. Select your event from the list.

  3. Scroll down to the Country or Region Availability section.

  4. Select start and end dates and times. You can choose any date in the future for the start date. The end date can be a maximum of 31 days from the start date. Events must be at least 15 minutes long.

    Note: You can have up to 5 events with overlapping start dates and times, either approved or in draft status, at the same time.

  5. Select a publish start date and time. The publish date is when your event will become discoverable on the App Store and can be a maximum of 14 days in advance of the start date.

  6. On the top right, click Save.

Customize event start dates and times

The Customize Dates and Times option allows you to select different start times in one or more countries or regions on the App Store. If you choose to start your event on different days in different locations, all of your event start dates must be within 48 hours of each other.

  1. In the left sidebar, click In-App Events.

  2. Select your event from the list.

  3. In the Country or Region Availability section, click Customize Dates and Times.

  4. Select the locations you want to edit, and click Next.

  5. Enter the start date and time. Use the Time Zone toggle on the top right to choose a time zone.

  6. Click Done.

  7. To customize more regions, click the add button (+) next to Customize Dates and Times.

  8. Select the locations you want to edit, and click Next.

  9. Enter the start date and time.

  10. Click Done.

Add additional information

  1. Provide an event deep link. This link takes users who tap Open on the in-app event card or details page to the event content within your app. This can be a universal link (recommended for security) or custom URL. Avoid using URL shorteners and other services that add unnecessary redirects. Test the deep link to make sure it directs to the proper destination within your app — for example, you can paste your URL into the Notes app and tap it. Learn about configuring universal links.

  2. Select the general purpose of your event to help make sure your event reaches the most relevant users on the App Store.

  3. Select the priority for your event. Events appear chronologically on the product page based on start time, with the soonest start time displaying first. If you designate an event as High Priority, it will appear ahead of Normal Priority events.

  4. Indicate if an in-app purchase is required to participate in the event, as this information is shown on your event details page. For subscription apps, you only need to indicate that an in-app purchase is required when there’s an additional cost for the event specifically — for example, a pay-per-view event in a subscription app that requires an in-app purchase in addition to the standard subscription.

  5. Choose your event’s primary language. This will be the default language that displays to users if your event isn’t localized for their device’s language.