Back to Arduino Support

If your board does not appear on a port in Arduino IDE

Learn what to do if your board is missing from the board selector or Tools > Port menu.

Before you begin

  • Ensure you’ve connected your board with a working data USB cable.
  • Check that your device is powered. One or more more LEDs should be lit.
  • In earlier versions of Arduino IDE 2, the Tools > Port menu option would only be displayed if at least one device was detected on a port. This was fixed in version 2.0.4[1].
  • Classic Nano boards and some clone boards with generic USB chips will show up as “Unknown” in the board selector. When selecting an “Unknown” port you will be prompted to select the board type manually. Alternatively, select your board in the Tools > Board menu.
  • If you’re using a classic Arduino Nano, you may need to manually install FTDI drivers.
  • If you’re using an Arduino-based “clone” board with a CH340 USB chip, you may need to manually install CH340 drivers.

In this article

If there are “Unknown” devices in the board selector and without a board name in the Tools > Port menu

Arduino IDE will list detected serial ports in the board selector and Tools > Port menu.

  • If Arduino IDE is able to identify a device as an Arduino board, it will the board name instead of “Unknown” in the board selector. In the Tools > Port menu, the board name will appear after the port name, enclosed by parentheses.
  • In some cases, the port information is not sufficient to determine the type of board that’s connected, or if the connected device is a compatible board at alL. In this case, it will appear as an “Unknown” device in the board selector and show only the port name in the Tools > Port menu.

This example shows the board selector and Tools > Port menu on Windows when an Arduino UNO board and one other unidentified device is connected:

Identified and unidentified ports in the board selector (left) and Tools > Port menu (right).

The types of unidentified ports shown by Arduino IDE can be grouped in two categories:

  • Arduino-compatible boards that use generic USB chips:
    • The “classic” Arduino Nano, which uses a FTDI USB chip.
    • Various “clone” board with generic USB chips such as the CH340.
  • Ports that do not belong to an Arduino-compatible device, but are detected and shown by Arduino IDE anyway:
    • Some non-Arduino devices with generic USB chips.
    • Some Bluetooth ports.
    • Debug ports.

Note

If you have many unidentified ports showing up in the list, consider disconnecting any boards and peripherals you don’t need from your computer. Then, use this procedure to see whether your board is being detected on any of the ports.

Disconnect and reconnect your board to check its port

Using the board selector:

  1. Disconnect your board from your computer.

  2. Open the board selector menu.

  3. Connect your board to your computer.

If you’re using IDE 1, the board selector won’t be available. Use the Tools > Port menu instead:

  1. Disconnect your board from your computer.

  2. Open the Tools > Port menu. Some ports may still be listed. Take note of this, and close the menu.

  3. Connect your board to your computer.

  4. Open the Tools > Port menu. The port your board is connected to should now appear as a new port in the list.

Configure an unidentified board

If you’ve determined which port belongs to your board:

Using the board selector:

  1. Open the board selector.

  2. Select the “Unknown” board you want to use.

  3. In the pop-up “Select Other Board and Port” menu, select the board from the list.

  4. Click OK.

Using the Tools > Board menu:

  1. Open the Tools > Board menu.

  2. Choose the board you want to use.

For more information, see Select board and port in Arduino IDE.

If your board does not appear on any port

Note

If the Tools > Port menu is open, you need to close and re-open it for the list to refresh.

If you’ve determined that none of the listed ports belongs to your board, or of no ports are listed at all, check the following:

Check board connections

A common reason for the board not appearing on a port is a problem with the USB connection:

  1. The board needs to be connected to your computer with a data USB cable.
  2. Make sure the USB cable is not damaged. Test your cable with a different device, or try using a different cable.
  3. Try using a different USB port on your computer.
  4. If possible, connect the board directly to your computer instead of a through a hub.
  5. Remove any connections to the 0(RX) and 1(TX) pins when uploading code.

Install missing drivers

Some boards require special drivers for serial communication:

Try a bootloader reset if your board supports it

The board may be stuck in a state where it cannot communicate on the port. On some boards (such as those of the MKR Family and newer Nano boards), pressing the RESET button twice in quick succession will put the board in bootloader mode. Instead of running a sketch, the Arduino will wait until a sketch is uploaded. While in bootloader mode, an orange LED will fade in and out.

  1. Find the reset button on the board.

  2. Click the button two times in succession.

    The RESET button on Arduino Zero with an "x2" label graphic.

  3. Check the board selector or Tools > Port again.

Check for additional system information

If Arduino IDE is not displaying a port for your board, you may still get some information by using a dedicated software utility:

Windows
  1. Open the Device Manager by searching for it in the start menu. You can also try right-clicking the Start button and choosing Device Manager.
  2. In the Device Manager, open the Other Devices section.
  3. Review the list of devices.
macOS
  1. Press ⌘ + Space to open Spotlight. Search for the System Information app and open it.
  2. Select the Hardware > USB section.
  3. Review the list of USB devices.
Linux

Use a device manager of your choice, such as hardinfo.

To install and use hardinfo, follow these steps:

  1. Open Terminal and run sudo apt install hardinfo.
  2. Wait for the installation to complete, then run the hardinfo command.
  3. Check Devices > USB Devices
  4. Review the list of USB devices.

Here are some cases to look out for:

  • Missing drivers can cause your “classic” Nano board to be recognized as “USB Serial Port”, or some other generic name.

  • If your board is an UNO or Mega board, missing or corrupted USB-to-Serial firmware may cause the board to be recognized as any of the following:

    • Unknown Device
    • Unknown USB Device
    • Composite Device
    • USB Device
    • ATmega16u2 DFU
    • Atmega8U2 DFU

    If your board is listed with one of these names you may resolve the issue by flashing the USB-to-serial firmware in DFU mode.

Still need help?

  1. https://github.com/arduino/arduino-ide/releases/tag/2.0.4 ↩︎

  • Last edited:
Was this article helpful?
Do you want to contribute? Visit the Github repository
Return to top

Didn’t find what you were looking for?

Arduino Docs

Tutorials, data sheets, guides and other technical documentation.

Arduino Forum

Connect with the community, get help with your project, and discuss everything Arduino.

Arduino Discord

There are a lot of Arduino enthusiasts who are more than willing to help out. Head over Discord to start a discussion.

Contact Arduino

Need help with a product, need to make an exchange, or can't find a question answered? Email us and we'll answer as soon as possible.