What is the correct WLED 2D setup for an 8×8 matrix?

Set First LED position to bottom right, Orientation to vertical, Serpentine to on, and Dimensions to 8 wide by 8 high (8×8), matching a typical serpentine strip layout.

How do I configure WLED for a 16×16 matrix?

Use First LED position top left, Orientation vertical, Serpentine enabled, and Dimensions 16×16 for the common serpentine 16×16 panel wiring shown in this guide.

What WLED 2D settings should I use for a 32×8 matrix?

Use First LED position bottom right, Orientation vertical, Serpentine on, and Dimensions 32 wide by 8 high (32×8).

WLED 2D Matrix Setup for 8×8, 16×16 & 32×8

Many builders get stuck on first LED position, serpentine, and width vs height. This guide matches real panel layouts to the exact WLED 2D settings—so pixel art, effects, and apps like Pipplee map correctly.

The problem

WLED’s 2D configuration screen asks for several choices at once. If any one of them disagrees with how your strip is actually wired, the whole grid is rotated, mirrored, or scrambled. That looks like a “bug” in software, but it is almost always a mapping mismatch.

First LED position — where index 0 sits on the physical panel.
Orientation — whether columns or rows advance along the strip direction you wired.
Serpentine — every other row (or column) runs backward compared to the previous one.
Dimensions — width × height in LEDs, not centimeters.

The solution

Below are three reference layouts for the most common hobby matrices. Each section shows a wiring / layout diagram and a WLED UI screenshot so you can compare your hardware side by side. If your strip starts in a different corner or runs non-serpentine, change only the settings that differ—keep the rest as a starting point.

8×8 matrix

Typical small panel or tiled 8×8 grid. Use these values in WLED → LED preferences → 2D configuration when your wiring matches the diagram.

Setting	Value
First LED position	Bottom right
Orientation	Vertical
Serpentine	On (checked)
Dimensions	8 × 8 (width × height)

8 by 8 LED matrix wiring diagram: serpentine path and first LED at bottom right — 8×8 layout reference (strip path and start corner).

WLED 2D configuration screenshot for 8x8 matrix: bottom right, vertical, serpentine, 8 by 8 — Matching WLED 2D settings in the app / web UI.

16×16 matrix

Very common mid-size panel. Note the different first LED anchor compared to 8×8—your strip must match the diagram for these numbers to work.

Setting	Value
First LED position	Top left
Orientation	Vertical
Serpentine	On (checked)
Dimensions	16 × 16 (width × height)

16 by 16 LED matrix wiring diagram: serpentine path and first LED at top left — 16×16 layout reference.

WLED 2D configuration screenshot for 16x16 matrix: top left, vertical, serpentine, 16 by 16 — WLED 2D configuration for 16×16.

32×8 matrix (“wide strip” panel)

Popular for scrolling text and wide displays. Width is 32 LEDs, height 8—enter both in WLED exactly as below.

Setting	Value
First LED position	Bottom right
Orientation	Vertical
Serpentine	On (checked)
Dimensions	32 × 8 (width × height)

32 by 8 LED matrix wiring diagram: serpentine path and first LED at bottom right — 32×8 layout reference.

WLED 2D configuration screenshot for 32x8 matrix: bottom right, vertical, serpentine, 32 by 8 — WLED 2D configuration for 32×8.

Size-specific guides: 16×16 · 32×32 · 32×8
· Still looks wrong? Toggle one setting at a time (mirror axes in 2D, or flip serpentine) and retest with a simple left-to-right wipe. For full app setup, see our How it works guide, then control your matrix with Pipplee on Android or iOS.