Adding the ESP8266 board to the Arduino IDE

Adding the ESP8266 board to the Arduino IDE

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 (i.e. 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.
Donate via PayPal

Save, share & Disqus

Use the buttons below, on the left or the bottom of this page to share this post. Your comment is important, but don't be a knob. Keep it constructive and polite.

Comment via Disqus

Disqus is a worldwide comment hosting service for web sites and online communities. This secure platform ensures a pleasant commenting environment which is manageable from one account. Use the Login button to sign up.

More ESP8266 related posts

Try one of’s online software and skills learning courses
Try one of’s online software and skills learning courses
4 April 2020
Ad: Improve your knowledge on anything from programming to business skills with’s huge range of professional video courses. More…
Using the Arduino IDE to program the ESP8266
Using the Arduino IDE to program the ESP8266
12 October 2018
After several steps of preparation, the ESP8266 can finally be programmed. Fortunately this step has been made fairly simple by using, what is a familiar platform for many, the Adruino IDE. This post will show how to upload a few variations of the basic Blink sketch to an ESP-01 together with the wiring of LEDs. More…
The FTDI USB/UART module (FTDI programmer)
The FTDI USB to TTL serial converter module
5 June 2018
The FTDI USB to TTL serial converter module is an UART (universal asynchronous receiver-transmitter) board used for TTL serial communication. It is a breakout board for the FTDI FT232R chip with an USB interface, can use 3.3 or 5 V DC and has Tx/Rx and other breakout points. More…