# App Store release notes formatter

> Paste your notes the way you wrote them, in Markdown, as commit messages or as a plain list, and copy back text ready for the What's New box in App Store Connect. Nothing leaves your browser.

Use it here: https://ipip.fyi/tools/app-store-release-notes-formatter (it runs in your browser, nothing is uploaded).

## What it does

It turns release notes written for developers into text for the What's New box in App Store Connect. Markdown marks like `**bold**`, `#` headings and `[links](url)` become plain words, HTML tags are taken out, and list lines get the bullet you pick. If you paste commit messages that start with `feat:`, `fix:` or `perf:`, it groups them under New, Improved and Fixed, and leaves out internal ones like `chore:`, `test:` and `ci:`. Short commit hashes from `git log --oneline` are dropped too. Then it counts the result against Apple's limit.

## Apple's rules for What's New

| Rule | What Apple says |
| --- | --- |
| Length | Limited to 4000 characters |
| First version | Not available for your first version, required for every update after it |
| Languages | Can be localized, so each language has its own notes |
| Format | Plain text with line breaks, the same as the description, where HTML isn't supported |

Apple also recommends detailed notes, so people know the specific changes, improvements or fixes. "Bug fixes and performance improvements" on its own tells them nothing, so the tool flags it.

## What it can't tell you

It tidies and counts. It can't tell whether a change is worth mentioning, and it reads commit messages only by their prefix, so a commit called "stuff" stays "stuff". Read the result once as a customer would before you paste it.

## Questions

**How long can App Store release notes be?**

Up to 4000 characters. Apple calls the field "What's New in this Version" in App Store Connect.

**Can I use Markdown or HTML in App Store release notes?**

No. The field takes plain text with line breaks. Markdown marks and HTML tags show up as typed, so take them out or let this tool do it.

**Do I need release notes for my first version?**

No. Apple doesn't offer the field for the first version of an app. Every update after that needs it.

**Can I write release notes in more than one language?**

Yes. What's New can be localized, so each language you support on the App Store can have its own notes.

**Are my notes uploaded anywhere?**

No. The formatter runs in your browser and never sends your text to iPip or anyone else.

## Sources

- [Apple: Platform version information](https://developer.apple.com/help/app-store-connect/reference/app-information/platform-version-information/)

Updated November 22, 2026.

Source: https://ipip.fyi/tools/app-store-release-notes-formatter
