Switch error 2123-1502: the download could not stay connected

Error code 2123-1502 appears on Nintendo Switch when connecting to the internet, downloading software or updates, or launching downloadable software, and the connection does not hold. Nintendo's support entry for this code centers on the download failing mid-stream: the console starts talking to the servers, then the connection breaks. Weak Wi-Fi, sleep interrupting downloads, DNS problems, and occasionally Nintendo-side issues cover nearly all cases.

Fix it, in order (Nintendo's steps, expanded)

  1. Attempt the download again. Nintendo's first instruction for this code, because a single dropped connection is often just that. Select OK to close the error and restart the download from the Home screen icon.
  2. Restart the console fully (hold Power, Power Options, Restart), not just sleep, then retry.
  3. Keep the console awake and close to the router during the download. Sleep mode interrupting transfers is a documented cause; dock it or disable automatic sleep in Settings while the download runs.
  4. Restart the router and modem if downloads keep dying, and test whether other devices hold connections normally.
  5. Change the DNS settings manually: in the internet connection settings, set DNS to Manual and use a public resolver (primary 8.8.8.8, secondary 8.8.4.4). DNS resolution failures are a known trigger for this code, and Nintendo's community guidance leans on this fix heavily.
  6. Check Nintendo's network status page if everything local checks out; server maintenance produces this code on perfectly healthy consoles.
  7. Clear the cache (Settings, System, Formatting Options, Clear Cache) if the code clings to one download, then retry it.

Why big downloads suffer most

A connection that survives web browsing can still fail a 15 GB game download, which needs the link to stay healthy for a long, continuous stretch. That is why 2123-1502 clusters around large games and day-one patches: the error measures endurance, not basic connectivity. Fixes that improve endurance, proximity, no sleep, a rested router, a solid DNS, are the ones that end it.

Common questions

The download restarts from zero every time. Normal? Interrupted Switch downloads generally resume, but repeated 2123-1502 failures can make progress feel stuck. Fixing the connection cause matters more than persistence; after the DNS change and a no-sleep attempt, most downloads complete in one run.

Is my Switch broken? Very unlikely. This is a communication code, and Nintendo's own remedies are all network and retry steps. Hardware enters the conversation only if the console cannot hold any connection on any network, including a phone hotspot test.

Related

PS5 error CE-108255-1 · Steam connection error · DNS_PROBE_FINISHED_NXDOMAIN · ERR_NAME_NOT_RESOLVED