Adding the ESP8266 board to the Arduino IDE

Adding the ESP8266 board to the Arduino IDE
Published: by

The ESP8266 community created an add-on for the Arduino IDE that allows Arduino-like (C or C++) programming to be uploaded/flashed as software for the ESP8266 microcontroller.


This add-on enables the ESP8266 (e.g. ESP-01 boards) to be selectable as a ‘core’ under the Tools -> Board menu and will make this microcontroller compatible with the Arduino IDE. By adding the ESP8266 core to the Arduino IDE, an extensive range of libraries and sample code is also added.

Arduino IDE ESP8266 core

For quick reference, see the YouTube video on Popcorn Electronics.

You will need

  • Latest version of the Arduino IDE for your operating system.
  • Internet connection with more than 150 Mb data.

This post was done using Windows 10 and the Arduino IDE Store version 1.8.5.

Additional Boards Manager URLs

Adding the ESP8266 board is similar to adding any other third party core to the Arduino IDE – by using the Boards Manager. Before doing so, the ESP8266 JSON file needs to be added to the ‘Additional Boards Manager URLs’ under Preferences (File -> Preferences).

Arduino IDE preferences screen
Before being able to use the Arduino IDE Boards Manager to install the ESP8266 core, the JSON file must first be added to the Preferences -> Additional Boards Manager URLs.

By clicking on the folder icon next to Additional Boards Manager URLs, the Additional Boards Manager URLs popup screen will appear where multiple JSON files can be added at the same time. To add the ESP8266 core JSON file, copy and paste the link below into the space provided and choose OK. Choose OK again for the Preferences to accept the URLs.

Arduino IDE Additional Boards Manager URLs

Additional boards can be added at any time.

Boards Manager

This will take to you back to the Arduino IDE programming screen. The ESP8266 will now be selectable from the Boards Manager (Tools -> Board -> Boards Manager).

To go to the Boards Manager, go to Tools -> Board -> Boards Manager…

When the Boards Manager opens, a selection of installed and available boards will be listed. Before the list is accessible, the index file has to be downloaded.

From the Arduino IDE Boards Manager, use the search bar at the top and type in ESP8266. This will filter the options to the ‘esp8266 by ESP8266 Community’ core. Click on it, choose the desired/latest version and press Install.

Depending on the speed of your internet connection, the installation process can take several minutes to complete. After completion, press the Close button.

Choosing the ESP8266 board

After the ESP8266 core has been installed, it can be chosen as a Board form the Arduino IDE Board Menu (Tools -> Board -> ESP8266 Modules). Scrolling might be needed.

Arduino IDE board menu

About the author
Renier busies himself with improving his English writing, creative web design and his websites, photoshopping, micro-electronics, multiple genres of music, superhero movies and badass series.
Behind the Scenes is a free, informative website. If you find value in any of our content, please consider making a donation to our cause, or becoming a Patron for exclusive content.
Donate via PayPal Become a Patron

Save, share & discuss

Your comment is important, but don't be a knob. Keep it constructive and polite.

Leave a Reply

Your email address will not be published. Required fields are marked *

More ESP microcontroller related posts