ESP32 SPIFFS or LittleFS mount failed: partition and format fixes

“Mount failed” usually means the file system was never formatted or the partition scheme has no space for it.

What the message means

The flash holds a partition table. If it has no SPIFFS or LittleFS partition, or the partition is blank, mounting fails.

Fix it in this order

1. Start the file system with the format-on-fail option, for example LittleFS.begin(true), for the first run.
2. In the Arduino IDE choose a Partition Scheme that includes SPIFFS or LittleFS.
3. Match the library to the partition type. A SPIFFS partition needs the SPIFFS library; the LittleFS library needs LittleFS.
4. Upload the data folder with the upload tool that matches your IDE version.
5. Check the file size against the partition size.
6. Open the file with the full path starting with /.

Why it happens

The file system mount fails when the partition scheme has no space for it, when the board was never formatted, or when the library and the file system type do not match.

Choose a partition scheme that includes SPIFFS or LittleFS, and call begin(true) so a failed mount formats the file system once.

if (!LittleFS.begin(true)) {   // true: format on failure
  Serial.println("mount failed");
}

Example sketch: change pins and values for your own wiring. It has not been bench-tested on your hardware.

If you see this, do this

Related

invalid header, wrong boot mode.

Last reviewed: November 2026. These are the usual causes and the order that finds them fastest. Test on your own board; clones and cables differ.