Arduino NodeMCU (ESP8266) Spiffs File System Uploading and Reading

In this tutorial we upload a text file and read it in serial monitor.

Steps to Upload a file in NodeMCU SPIFFS file system

ESP8266FS is a tool which integrates into the Arduino IDE. It adds a menu item to Tools menu for uploading the contents of sketch data directory into ESP8266 flash file system.

  • Restart Arduino IDE
  • Open a sketch (or create a new one and save it)
  • Go to sketch directory (choose Sketch > Show Sketch Folder)
  • data older next to your .ino file
  • Create a directory named data and put your files you want in the file system there

  • Make sure you have selected a board, port, and closed Serial Monitor
  • Select Tools > ESP8266 Sketch Data Upload. This should start uploading the files into ESP8266 flash file system. When done, IDE status bar will display SPIFFS Image Uploaded message. Note during upload it takes longer time.


Reading Uploaded File

In above process we uploaded notes.txt file in ESP flash. In this program we read it and display its contents in serial monitor. Uploading of sketch will not affect sketch data. i.e. uploaded notes.txt file.

 *  ESP8266 Communication and Protocols
 *  SPIFFS Direct File Upload Example
 *  -Manoj R. Thkuar

#include <ESP8266WiFi.h>
#include <FS.h>   //Include File System Headers

const char* file = "/notes.txt";   //Enter your file name

void setup() {

  //Initialize File System
  Serial.println("File System Initialized");

  File dataFile =, "r");   //Open File for reading
  Serial.println("Reading Data from File:");
  //Data from file
  for(int i=0;i<dataFile.size();i++) //Read upto complete file size
    Serial.print((char);    //Read file

void loop() {



In serial monitor you will get File contents, you can upload images, html and javascript files. examples can be found here

  1. Image upload and display
  2. JavaScript Gauges

One thought on “Arduino NodeMCU (ESP8266) Spiffs File System Uploading and Reading

Leave a Reply