seoskills.sh

In App Events

Create, plan, or optimize App Store In-App Events: the event cards that appear on the Today tab, search results, and your product page.

Listed ·Updated

2.3K installs

Install data from skills.sh

About this skill

Creates briefs for App Store In-App Events, the time-limited cards shown on the Today tab, in search results and on your product page. Your app's category and goal (re-engagement, new users or a feature launch) decide which of six event types fits, such as Challenge, Premiere or Major Update. Each brief holds a 30-character name, 50- and 120-character descriptions, art direction for the 2160 by 1080 pixel card, KPIs and a submit-by date that allows for App Store review. Names lead with the user benefit, never the app name, since the store indexes them for search. The skill treats re-engaging lapsed users as the main payoff and recommends at least one event a month, mapped on a monthly calendar.

What it needs

  • App Store Connect access, to submit and schedule the events
  • App marketing context file at app-marketing-context.md (optional)
  • The author's keyword-research skill (optional, for choosing event-name keywords)

Try asking

  • Write In-App Event copy for our puzzle game's weekend tournament
  • Plan an App Store event to win back lapsed users of our recipe app
  • Draft a three-month In-App Events calendar for our language learning app

Compare with

  • Seasonal ASO by appeekySame author, for holiday changes to the listing itself: seasonal keywords, subtitle, promotional text and screenshots, with a revert date.
  • Metadata Optimization by appeekyWrites the core listing copy instead: title, subtitle, keyword field and description, each with alternatives and character counts.
  • ASO Audit by appeekyA ten-factor listing audit scored out of 100, where using in-app events is one small conversion check.
  • ASO by coreyhaines31Scores the live listing out of 100 and flags missing events, except for household-name apps; writes no event copy.

SKILL.md

In-App Events

You help the user plan, write, and optimize App Store In-App Events — event cards that surface in search, the Today tab, and the product page, driving installs and re-engagement without paid media.

What In-App Events Are

In-App Events are time-limited content cards on the App Store. They appear:

  • Today tab (editorial + algorithmic)
  • Search results (alongside app results)
  • Your product page
  • Personalized recommendations (for lapsed users)

Key advantage: Existing users who haven't opened your app recently are notified of events. Non-users see them as discovery.

Event Types

TypeBest ForExample
ChallengeUser-generated competition"30-Day Streak Challenge"
CompetitionRanked or scored contest"Weekly High Score Leaderboard"
Live EventReal-time activity"Live Q&A with Experts"
Major UpdateSignificant new feature"Introducing AI Coach"
PremiereFirst-time content launch"New Series: Morning Routines"
Special EventSeasonal or themed moment"Holiday Collection Unlocked"

Event Card Specs

FieldLimitNotes
Event name30 charsAppears prominently — keyword-conscious
Short description50 charsBelow the name on cards
Long description120 charsShown in expanded event view
Event card image2160×1080px2:1 ratio, PNG/JPG, no text required
Badge—Chosen from the 6 type badges above
DurationUp to 31 daysStart and end time required

Up to 10 events can be live or scheduled at a time.

Planning Workflow

Step 1 — Event Idea Selection

  1. Check for app-marketing-context.md
  2. Evaluate event type based on app category:
App TypeBest Event Types
GamesChallenge, Competition, Major Update
FitnessChallenge, Live Event, Major Update
ProductivityMajor Update, Premiere
Social / CommunityLive Event, Challenge
Streaming / ContentPremiere, Special Event
UtilityMajor Update, Special Event
  1. Identify the primary goal:
    • Re-engagement → Use notification-triggering events (any type)
    • New user acquisition → Focus on Today tab visibility (Challenge or Competition)
    • Feature launch → Major Update type

Step 2 — Write Event Copy

Event name (30 chars) — rules:

  • Lead with the user benefit or action, not your app name
  • Include relevant keywords where natural
  • ✅ "30-Day Habit Challenge" | ❌ "AppName Challenge 2026"

Short description (50 chars):

  • Answer "what's in it for me?" in one line
  • ✅ "Build a streak and win exclusive rewards"

Long description (120 chars):

  • Expand on the short description: what, when, and why to join
  • ✅ "Join our 30-day challenge. Complete daily habits, hit your streak, and unlock your achievement badge."

Step 3 — Event Card Image

Spec: 2160×1080px, 2:1 ratio

Best practices:

  • No text needed (name/description appear as overlay) — but a short tagline is allowed
  • High contrast, bold visual that works at small thumbnail size
  • Show the outcome or reward, not just the app UI
  • Test thumbnail at 390×195px to verify legibility

Step 4 — Submit in App Store Connect

  1. App Store Connect → Your App → In-App Events → +
  2. Fill all required fields + upload image
  3. Submit for review (typically 24–48 hours)
  4. Schedule start/end times

Submit 3–5 days before the desired start date to account for review time.

Optimization Tips

Maximize Today Tab Placement

Apple's algorithm favors events that are:

  • Timely — tied to real-world moments (holidays, trends, app anniversaries)
  • High quality — polished images, complete descriptions
  • Engaging — event types that drive sessions (challenges > updates)
  • Consistent — apps that run regular events get better recurring placement

Run at least one event per month to maintain algorithmic eligibility.

Keyword Visibility in Search

Event names and short descriptions are indexed by the App Store search algorithm.

  • Include 1–2 target keywords in the event name naturally
  • The short description can reinforce secondary keywords
  • Use keyword-research skill to validate which terms to include

Re-engagement Notification

Users who have downloaded your app but haven't opened it recently receive a push notification for your event automatically — no opt-in required. This is the highest-value feature of In-App Events.

Make the event name the notification subject line — write it to be compelling as a standalone message.

Output Format

Event Brief

📅 Event: [Name — 30 chars]
   Type:  [Badge type]
   Dates: [Start] → [End]

Copy:
  Short:  [50 chars]
  Long:   [120 chars]

Image direction:
  Visual: [describe the scene/concept]
  Style:  [photography / illustration / abstract]
  Key element: [the reward, the action, the outcome]

Goals:
  Primary: [re-engagement / acquisition / feature launch]
  KPIs: [sessions spike, downloads, event page views]

Submit by: [date — 4 days before start]

Event Calendar (monthly)

Week 1:  [Event name] — [type] — [dates]
Week 2:  [No event / buffer]
Week 3:  [Event name] — [type] — [dates]
Week 4:  [Event name] — [type] — [dates]

Common Mistakes

MistakeFix
App name in event nameLead with the user benefit
Generic image (screenshot of UI)Show the reward/outcome visually
Events shorter than 7 daysMinimum 7 days for Today tab consideration
Submitting day-ofSubmit 4–5 days early for review
No recurring scheduleRun 1+ events/month for sustained placement

Related Skills

  • seasonal-aso — Align event timing with keyword seasonal peaks
  • screenshot-optimization — Apply same visual best practices to event images
  • app-store-featured — Events increase editorial feature eligibility
  • retention-optimization — Track re-engagement lift from events

Not using the CLI? Copy the SKILL.md and paste it straight into ChatGPT, Claude, or any agent.

View appeeky/aso-skills on GitHub

Embed a badge

seoskills.sh listing badge