Skip to content

Store Pitfalls #7: Listing Image & Keyword Input Quirks

2026-07-10

Tags: Windows · Microsoft Store · Store Pitfalls


Not every Store Pitfall is a certification blocker. Some are just quiet time-sinks — things Partner Center doesn't document, that you stumble through the slow way until one day you realize there was a faster path all along.

This one covers two of those, both on the listing editor: replacing images and entering keywords. Neither will reject your submission. Both will waste your time if you don't know the trick.

Pitfall 1: Replacing a Listing Image

The slow way

When I needed to update a screenshot or cover image on a listing — say, after a UI refresh — here's what I used to do:

  1. Upload the new images one by one, so they land in the right sort order
  2. Copy the caption from each old image to its replacement
  3. Delete the old images one by one

Three steps per image, and every caption had to be manually copied over. For a single language that's tedious. For a listing localized across 10 languages, each with multiple screenshots, it's an afternoon of busywork.

The fast way

You can just drag the new image directly on top of the old one. Partner Center replaces it in place — same position, same sort order, same caption, no deletion needed.

I'd been publishing to the Store for months before I noticed this. The upload tile doesn't hint at it; there's no "Replace" button labeled as such. But if you drop a new file onto an existing image slot, it swaps.

This is especially valuable when you only need to refresh one screenshot out of a set — you keep the other nine exactly where they are.

Pitfall 2: The Keyword Input That Swallows Enter

The trap

The keyword field in the listing editor shows a dropdown of suggested keywords as you type. Helpful in theory. But there are two silent failure modes, and the second one is worse than you'd expect.

Mode 1 — Enter does nothing. If the text you've typed is a prefix of one of the suggested keywords, pressing Enter doesn't register. No error, no feedback. You sit there hitting Enter a few times, wondering if the page is frozen.

Mode 2 — Enter works, but invisibly. This is the nasty one. Sometimes the keyword is added, but the UI doesn't show it. You think Enter failed, so you try again, maybe with a slightly different spelling, hit Enter a few more times, move on to the next keyword… and then the field tells you it already has 7 keywords — the maximum — even though you can only see one or two.

The missing keywords are real. They're stored, they count against your limit, and you can't see or delete them without a full page reload.

The recovery

Once you've got invisible keywords clogging the field:

  1. Save draft (so you don't lose other edits)
  2. Reload the page and reopen the listing
  3. The previously-invisible keywords now appear — delete the wrong ones
  4. Try again, carefully, one at a time

Workaround A: The space prefix

Type a single space first, before your keyword. Since no suggestion starts with a space, the autocomplete won't match anything, and Enter submits your actual text.

Workaround B: Listing CSV export/import

For more than a couple of keywords — or when the UI has already gone into a bad state — use the listing CSV export instead:

  1. Click Export to download the entire store listing as CSV (there's no keywords-only export)
  2. Find the keyword columns and edit them in any spreadsheet app
  3. Upload the CSV back

This sidesteps both failure modes completely. It's heavier than editing in the UI — you're touching the whole listing — but it's the only reliable path once the keyword field has accumulated invisible junk.

The Takeaway

  • Replacing images: drag the new file onto the existing slot — no need to delete and re-upload.
  • Adding keywords: the input has two failure modes — Enter doing nothing, and Enter working invisibly. Watch the keyword count after every submission; if it jumps without a new keyword appearing, reload the page before continuing. For more than a keyword or two, CSV import is the only reliable path.

Neither of these is documented anywhere I could find. They're the kind of thing you either discover by accident or suffer through for months. Hopefully this saves you the suffering.


Part of the Store Pitfalls series.