Which LED strips and controllers are compatible with WLED?

Updated

WLED runs on ESP8266 and ESP32 boards and drives addressable LED strips built on the NeoPixel family (WS2812B, WS2811, SK6812), SPI chipsets such as WS2801 and APA102, and HUB75 video wall panels. If your strip uses one of those chipsets and your controller is an ESP8266 or ESP32, it is compatible in principle. The practical limits are the number of LED outputs per board and whether you need RGBW or a 2D panel.

Compatible LED strips and chipsets

WLED's own documentation groups supported LEDs into two families:

Family Chipsets named in the docs Notes
NeoPixel-style (single-wire) WS2812B, WS2811, SK6812 The most common hobbyist strips; driven from a single data pin
SPI-based WS2801, APA102 Separate clock and data lines
Video wall panels HUB75 Treated as a distinct 2D output, not a strip

RGBW strips are explicitly supported, which matters if you want a dedicated white channel rather than mixing white from RGB. The docs also list "Multi-strip Support" and "Mixed 2D and 1D Bus" as features, so a single controller can drive more than one strip type in one setup.

Compatible controllers

WLED is an ESP32/ESP8266 webserver implementation, so the controller must be one of those two chip families. The documentation's "Compatible hardware" section covers controllers, and the compatibility pages split into LED strips, controllers, and other hardware.

Output capacity differs by chip:

  • ESP8266: up to 3 LED outputs per instance
  • ESP32: up to 10 LED outputs per instance

That is the number of independent data outputs, not the number of LEDs. Total LED count is limited by your power supply, injection, and the data protocol rather than by a single published ceiling in this material.

How to check your own hardware

  1. Identify the chip printed on your strip (for example WS2812B or SK6812) or the driver IC on an SPI strip (WS2801, APA102).
  2. Confirm your board's microcontroller is an ESP8266 or ESP32 — not a Raspberry Pi, Arduino Uno, or similar.
  3. Count how many separate outputs you need. Three or fewer fits an ESP8266; up to ten fits an ESP32.
  4. If you need a dedicated white channel, check that your strip is an RGBW variant.
  5. If you are building a video wall rather than a strip run, confirm the panel is HUB75.

Common mismatches

  • Non-addressable strips (plain 12V or 24V RGB with a single color for the whole run) are not what WLED drives; it expects individually addressable pixels.
  • Analog-only or proprietary controllers cannot be reflashed to run WLED unless they contain an ESP8266 or ESP32.
  • Assuming output count equals LED count. Adding a second output means another data line and another injection point, not just more LEDs on the same wire.

The WLED documentation's "Compatibility" section and its "LED strips," "Controllers," and "Other Hardware" pages are the place to confirm a specific part before buying. If your strip's chipset appears in the table above and your board is an ESP32 or ESP8266, you can proceed to the Quick Start and wiring guides.