storebound/docs/drafts/header-search-results-announcement.md

29 lines
1.8 KiB
Markdown

# Draft: Header and Search Results support (not posted)
## Release tweet
storebound now fills App Store Connect's new Header and Search Results: a 21:9 product page header and a 3:2 search
results asset per language, image or video, checked locally, uploaded once, selected on the version and added to the
draft review submission. You still press Submit. `storebound apple creative-assets --dry`
## Announcement
**App Store Header and Search Results, end to end**
Since October 2026, App Store Connect has a Header and Search Results tab next to App Previews and Screenshots. On
iOS and iPadOS 27 these assets show at the top of the product page and in search results.
`storebound apple creative-assets` handles the whole flow through the App Store Connect API:
- **Checks before upload.** Header 3840 x 1646 (21:9), search results 3:2 (1920 x 1280 up to 3840 x 2560), or one
universal 5244 x 2950 PNG for both. No alpha. Videos run 5-30 s at 30 or 60 fps, and search videos play muted.
- **Upserts into the Asset Library.** Each file goes up once, matched by MD5. Re-runs send nothing. Archived copies are
restored instead of uploaded again, and a file App Review rejected is never re-sent.
- **Selects the assets on the version** once they are processed, as the console's Browse Assets does. No waiting on an
approval that only a submission can start.
- **`--add-for-review`** puts the new assets into the draft review submission, along with your first version or on
their own after that. storebound never submits; Submit for Review stays your button.
- **`--verify`** reads every slot back without writing and fails if a slot does not show your local file.
Dry run by default over MCP (`apple_creative_assets`, `apple_creative_assets_verify`). Google Play has no such slot.
The feature graphic and promo video are the closest match there.