How to reset WiFi credentials / regain access to WLED
The onboard button (GPIO 9) on the MagWLED-1 has several built-in behaviors depending on how long you hold it.
Button reference
| Action | Result |
|---|---|
| Short press | Toggle LEDs on/off |
| Long press (~2s) | Select a random color |
| Hold >6 seconds | Re-enables WLED-AP hotspot (WiFi settings reset to defaults) |
| Hold >12 seconds | Full factory reset — all settings and flash memory erased |
Moved to a new network? Wait 60 seconds first
WLED has a built-in fallback: if it can’t connect to the saved WiFi network within about 60 seconds, it automatically re-enables the WLED-AP hotspot. You don’t need to do anything — just wait a minute after powering on in the new location and WLED-AP should appear.
Once connected to WLED-AP:
- Open
4.3.2.1in your browser - Go to Config → WiFi Setup
- Enter your new network credentials and save
If WLED-AP doesn’t appear after 60 seconds: use the 6-second button hold
If the automatic fallback doesn’t kick in:
- Hold the button for more than 6 seconds while the device is powered on
- Release — the WLED-AP hotspot will become available (password:
wled1234) - Connect and reconfigure as above
Full factory reset: 12-second hold
Holding the button for more than 12 seconds erases all flash memory — presets, segments, WiFi credentials, everything. Use this as a last resort if the device is in an unrecoverable state.
If the button isn’t accessible
If you still have network access to the device, you can reset WiFi settings via the WLED interface: Config → Security & Updates → Reset settings.