ESP32 Bench
Boards: ESP32, S3, C3
Flash and monitor: Web Serial
← All errors

Sketch too big: text section exceeds available space in board

Upload and connection

What it looks like

Sketch uses 1402386 bytes (107%) of program storage space. Maximum is 1310720 bytes.
Sketch too big; see https://support.arduino.cc/hc/en-us/articles/360013825179 for tips on reducing it.
text section exceeds available space in board

What it means

The compiled firmware is larger than the app partition. The default partition scheme gives each app 1.25 MB so that there is room for over-the-air updates; Wi-Fi plus Bluetooth plus TLS can exceed it.

Likely causes

  • Using Wi-Fi and Bluetooth in the same sketch.
  • Large libraries, fonts or images compiled into the firmware.
  • The default partition scheme reserving space for OTA.

How to fix it

  1. Pick a bigger app partition in Tools > Partition Scheme, such as "Huge APP (3MB No OTA/1MB SPIFFS)". You lose OTA updates.
  2. On boards with more flash, set Tools > Flash Size to match and pick a matching scheme.
  3. Drop libraries you do not use, and move fonts or images into LittleFS.

Paste your full log

The lines around the error usually say more. Paste everything from the reset to the backtrace and the crash translator explains each part. It runs in your browser; nothing is sent anywhere.