> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# App Store Screenshots

> Turn a raw app screenshot into polished, store-ready App Store screenshots with AI

# App Store Screenshots

The **Screenshot Editor** turns a plain screenshot of your app into a set of
polished, marketing-ready App Store images — device frame, background, brand
accent, and headline copy included. Upload (or capture) a screen, add a
headline, pick a brand color, and Newly generates four professionally-styled
layouts for every screen. You can download them or publish them straight to
App Store Connect.

<Note>
  Everything stays inside your project. Screenshots, copy, and brand color are
  scoped to the project, and your source pixels aren't stored permanently.
</Note>

## Opening the editor

The Screenshot Editor lives in the right-hand **tool strip** of your project,
in the distribution group next to **Deploy**. Click the **Screenshots**
(camera) icon to open the panel.

<Note>
  You need **edit** access to the project to upload, generate, and publish. If
  you don't see the Screenshots icon, the feature may not be enabled for
  your account yet — reach out on [Discord](https://discord.com/invite/sPbqWqgcMf).
</Note>

The panel walks you through four steps, top to bottom.

## Walkthrough

<Steps>
  <Step title="01 — Configure target">
    Pick the **device** you're creating screenshots for. Newly sets the
    exact pixel dimensions the store expects for that device — there's
    nothing else to size manually.

    | Device                         | Size | Dimensions |
    | ------------------------------ | ---- | ---------- |
    | iPhone 17 Pro Max / 16 Pro Max | 6.9″ | 1320×2868  |
    | iPhone Air / 16 Plus           | 6.7″ | 1290×2796  |
    | iPhone 17 Pro / 16 Pro         | 6.3″ | 1206×2622  |
    | iPhone 17 / 16                 | 6.1″ | 1179×2556  |
    | iPad Pro 13″                   | 13″  | 2064×2752  |
    | iPad Pro 11″                   | 11″  | 1668×2388  |
    | iPad mini                      | 8.3″ | 1488×2266  |

    <Tip>
      Start with **iPhone 6.9″ (1320×2868)**. It's the size App Store
      Connect requires for the primary iPhone screenshot set, and it's the
      one that can be published directly from Newly (see
      [Publishing](#publishing-to-app-store-connect)).
    </Tip>
  </Step>

  <Step title="02 — Add your screenshots">
    Get your app screens into the editor two ways:

    * **Upload** — click **Upload** or drag a file onto the drop zone. PNG or
      JPG only, up to 10 MB each.
    * **Capture from preview** — when you're previewing on an iOS or
      Android **simulator**, click **Capture from preview** to grab the current
      screen with no round-trip. (Not available on web or physical-device
      preview.)

    Add up to **6** screens per run. Click any screen's row to edit its
    marketing copy:

    * **Headline** — the big line, e.g. *"Track every workout"*
    * **Subhead** — the supporting line beneath it

    <Tip>
      Keep headlines to a few punchy words. They're rendered large over the
      background, so short copy reads best on a phone-sized listing thumbnail.
    </Tip>
  </Step>

  <Step title="03 — Choose a brand color">
    The brand color drives the AI-generated background and accent. Choose
    **Auto** to let Newly pull a palette from your screenshot, pick one of the
    presets (Sienna, Purple, Blue, Green, Red, Amber, Pink, Ink), or paste a
    custom hex value to match your brand exactly.
  </Step>

  <Step title="04 — Generate, preview & download">
    Click **Generate variants**. Newly generates **four layouts for every
    screen** you added:

    | Layout        | Style                                                        |
    | ------------- | ------------------------------------------------------------ |
    | **Classic**   | Phone large and centered, subtle drop shadow                 |
    | **Editorial** | Phone tilted slightly, copy left-aligned beside it           |
    | **Magazine**  | Phone offset to one side, copy on the other — editorial feel |
    | **Floating**  | Phone elevated with a large perspective shadow               |

    Generation runs in the background (typically a couple of minutes) and
    previews stream in as each image finishes. When it's done you can
    **Download** any single image or **Download all** as a ZIP.

    <Note>
      All four layouts are always generated for each screen — you pick your
      favorites afterward rather than choosing a template up front.
    </Note>
  </Step>
</Steps>

## Publishing to App Store Connect

If you've connected your Apple account in **Deploy**, you can skip the
manual upload entirely. Click **Publish to App Store**, select the images you
want in the gallery, and Newly uploads them to your app's screenshot set in
App Store Connect.

<Warning>
  Direct publishing currently supports the **iPhone 6.9″ (1320×2868)** set
  only, up to **10 screenshots**. Generate on that device to publish directly;
  for other sizes, download the images and upload them in App Store Connect
  manually.
</Warning>

If Apple isn't connected yet, the button reads **Connect Apple to
Publish** — set up your App Store Connect API key in
[Deploy settings](/subscriptions/app-store-connect-setup) first.

## Credits & limits

* **1 prompt per image.** A run costs `screens × 4` prompts — e.g. 2 screens =
  8 prompts. You're told up front if you don't have enough.
* **Up to 6 screens** per generation run; each run produces all 4 layouts.
* **Uploads:** PNG or JPG, max 10 MB per file.
* **Download links expire after 24 hours** — save anything you want to keep.
* A **Stale** badge appears if you change settings after generating. Hit
  **Generate variants** again to refresh.

## Tips for great screenshots

<AccordionGroup>
  <Accordion title="Capture clean source screens">
    Generate against the real content your users will see — a populated list, a
    finished chart, a completed profile. Newly frames and styles the screen
    exactly as provided; it doesn't redraw your UI.
  </Accordion>

  <Accordion title="Lead with your best screen">
    App Store listings show the first two screenshots in search results. Put
    your strongest screen and clearest headline first.
  </Accordion>

  <Accordion title="Use a consistent brand color">
    Pick one hex value and reuse it across every screen so the whole set feels
    like one campaign rather than four unrelated images.
  </Accordion>

  <Accordion title="Why does it always make four layouts?">
    Every screen gets Classic, Editorial, Magazine, and Floating so you can
    compare framings side by side and keep the ones that fit your app — no need
    to guess a template before you generate.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="App Deployment" icon="rocket" href="/features/deployment">
    Build and submit your app to the App Store and Play Store
  </Card>

  <Card title="App Store Connect Setup" icon="apple" href="/subscriptions/app-store-connect-setup">
    Connect your Apple account so you can publish directly
  </Card>
</CardGroup>