# Ledmap Not Displaying Correctly

**URL:** <https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888>\
**Category:** Issues\
**Created:** [October 2, 2025, 12:27am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888 "2025-10-02T00:27:08Z")\
**Posts on this page:** 19\
**Page:** 2

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [November 18, 2025, 8:00am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/21 "2025-11-18T08:00:43Z")

</div>

FYI: WROVER rev.1 needs special build with workaround for hardware bug when accessing PSRAM. PSRAM is no longer needed for large ledmaps in 0.16.

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 19, 2025, 2:43am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/22 "2025-11-19T02:43:01Z")

</div>

I installed it via the [install.wled.me](http://install.wled.me) site. It doesn’t give me an option to choose specific hardware. Should I be installing from somewhere else?

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 19, 2025, 2:44am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/23 "2025-11-19T02:44:08Z")

</div>

Oh good! I’ll try on one of my WROOM boards. I had only been using WROVER boards because of the PSRAM.

---

<div class="post-metadata">

**Author:** ![dedehai](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/dedehai/32/7265_2.png) [@dedehai](https://wled.discourse.group/u/dedehai)\
**Post date:** [November 19, 2025, 9:53am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/24 "2025-11-19T09:53:27Z")

</div>

in 0.16, WROOM now works quite well up to 3000 LEDs, probably a few more if they are virtual. but 64x64 is pushing the limits without PSRAM.

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 20, 2025, 12:36am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/25 "2025-11-20T00:36:15Z")

</div>

So it did install correctly on the WROOM, and there seems to be plenty of memory. Only 131kb of 983kb available. However, it’s not failing in a different way. It’s just not loading the LED map at all. I have tried 2 different builds of the LED map from 2 different map builders. Same result.

> **[Screenshot 2025-11-19 at 7.16.11 PM.png](https://drive.google.com/file/d/1WNTDv6x5qUKLwgsTz3dY58GughzPOT0g/view?usp=sharing)**
>
> Google Drive file.

Let me just list what I am doing to make sure I am not going about this all wrong.

1. Do a fresh install of 16.0
2. Go to LED Preferences
  1. Make 9 different LED outputs on 9 separate GPIO
  2. The first 7 have 250 LEDs per output with the WS281x type selected.
  3. The 8th has the remaining 172 LEDs with the WS281x type selected to get to the correct number of actual mapped LEDs in my build, 1922.
  4. The 9th output has 1030 LEDs with the WS281x type selected. I have been doing this to get to the final number of 2952 since my build consists of a 72 wide by 41 tall grid (2952) with only 1922 LEDs actually being used.

3. Go to the Edit page and upload my ledmap.json file.
4. Go to the 2D Configuration page and set the number of panels to 1, and the dimensions to 72x41.
5. Go to Segments and confirm its set to 72x41.

The result is the image above. a full rectangle with no map applied.

These are the 2 map files. Both clear a JSON validator (JSON Lint).

> **[ledmap (1).json](https://drive.google.com/file/d/1fxDGqGbBqLGMB3MwtAn0CRycOyg5LiIZ/view?usp=share_link)**
>
> Google Drive file.

> **[ledmap (2).json](https://drive.google.com/file/d/17j1mFyeGLNUoTE7FdaSA-rxvX-ZVsbGD/view?usp=share_link)**
>
> Google Drive file.

What am I doing wrong?

Thank you all for your help!

---

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [November 20, 2025, 6:51am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/26 "2025-11-20T06:51:28Z")

</div>

With _correct_ ledmap, you don’t need 2D set-up if you use “ledmap.json” file name.  
After uploading ledmap, you need to reboot.  
Additional ledmaps will ignore dimensions (will use dimensions from “ledmap.json”).

Your file “ledmap (1).json” is not a “valid” JSON file as far as WLED goes. Line breaks are at odd places.

Please provide a debug dump.

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 20, 2025, 1:02pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/27 "2025-11-20T13:02:05Z")

</div>

Thank You! I will work on that today. Was “ledmap (2).json” in the correct format?

1 was made using [WLED-Ledmap.json-Generator](https://intrinsically-sublime.github.io/WLED-Ledmap.json-Generator/)

2 was made using [SRGB Component Builder](https://effectbuilder.github.io/builder/index.html)

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 20, 2025, 1:53pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/28 "2025-11-20T13:53:54Z")

</div>

Wiped the board and installed the debug version. Used the ledmap (2).json file. Renaming it to just ledmap.json before uploading it. Did not do anything in the 2D matrix page. Rebooted after uploading. Still no map applied, just a 72x41 rectangle.

Here is the debug dump [https://drive.google.com/file/d/1Ll4si26dD36SwXcFb8v3\_1I1SjWGw4E5/view?usp=share\_link](https://drive.google.com/file/d/1Ll4si26dD36SwXcFb8v3_1I1SjWGw4E5/view?usp=share_link)

I see where it loads the ledmap. It doesn’t appear to throw any errors, but maybe I just don’t know what to look for.

Thank you for all your help!

---

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [November 20, 2025, 2:09pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/29 "2025-11-20T14:09:55Z")

</div>

Ledmap shows as loaded.

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 20, 2025, 3:36pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/30 "2025-11-20T15:36:19Z")

</div>

Should the “Peak” view be displaying the mapped LEDs? All I see is a full rectangle.

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 20, 2025, 3:37pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/31 "2025-11-20T15:37:25Z")

</div>

When I started this process I at least saw the shape of the map for the first ¾, then it went full width rectangle. Now I don’t even get part of the shape.

---

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [November 21, 2025, 7:05am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/32 "2025-11-21T07:05:22Z")

</div>

Start with a small ledmap.

---

<div class="post-metadata">

**Author:** ![garym999](https://avatars.discourse-cdn.com/v4/letter/g/7cd45c/32.png) [@garym999](https://wled.discourse.group/u/garym999)\
**Post date:** [November 21, 2025, 7:28am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/33 "2025-11-21T07:28:46Z")

</div>

You have experts here but I’m going to chime in with my recent experience just bumbling by…

In my application I have 4 panels of 14Wx17H pixels. To ease panel construction I used a continuous serpentine run of seed pixels. At each turn of the loop there was a pixel which I needed to skip. I used ledmap to define the leds in use and ones not. Then because I wanted to use the 2D effects I used the 2D configuration page to define the matrixes. This all worked fine in 14 but failed as I rolled to 15.

Trying to persevere with 15, I found that I needed to define the size of the matrix at the end of the ledmap file. Bam it all started working. 2D configuration still need to be applied for the 2D animations to appear.

I’ve also found that while you can get away with changes in the led settings page, if you make changes to the 2D config it’s best to reboot

Another tip is start with a much smaller test setup, get it working, then scale.

---

<div class="post-metadata">

**Author:** ![blazoncek](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/blazoncek/32/1886_2.png) [@blazoncek](https://wled.discourse.group/u/blazoncek)\
**Post date:** [November 21, 2025, 1:46pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/34 "2025-11-21T13:46:30Z")

</div>

Written in the [documentation](https://kno.wled.ge/advanced/mapping/).

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 22, 2025, 2:42am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/35 "2025-11-22T02:42:13Z")

</div>

OK. I think WLED just has a map limit. I tried a simple map, one of the example ones from the documentation, that worked. Then I tried gradually increasing the size of the matrix, and guess what, this new, from scratch, matrix failed at the exact same spot. That limit seems to be around 1991 LEDs.

Should I be reporting this as a bug on the Github page?

---

<div class="post-metadata">

**Author:** ![dedehai](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/dedehai/32/7265_2.png) [@dedehai](https://wled.discourse.group/u/dedehai)\
**Post date:** [November 22, 2025, 9:26am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/36 "2025-11-22T09:26:32Z")

</div>

no need, I already have a fix:

 ![image](https://global.discourse-cdn.com/free1/uploads/wled/original/2X/1/10e0d2f90c39629723825999489e2dc5dc2294df.jpeg)

this is what your ledmap looks like

> <https://github.com/wled/WLED/pull/5105>
>
> \- Show "-1" gaps in ledmap as black in peek preview
> \- fix segment overflow bug …when loading out-of-bounds preset

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 22, 2025, 5:38pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/37 "2025-11-22T17:38:06Z")

</div>

That is amazing THANK YOU!!! That is exactly what it should look like!

Is this going to be fixed in a future version, or is it part of the 16.0 nightly build?

Thank You so much again for all your help!!

---

<div class="post-metadata">

**Author:** ![dedehai](https://yyz2.discourse-cdn.com/free1/user_avatar/wled.discourse.group/dedehai/32/7265_2.png) [@dedehai](https://wled.discourse.group/u/dedehai)\
**Post date:** [November 22, 2025, 7:18pm UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/38 "2025-11-22T19:18:29Z")

</div>

you are welcome. this will be in the nightly build as soon as it is approved, you can test it by downloading the bin from that PR I linked i.e. artifacts here: [Display gaps in peek, fix segment overflow bug · wled/WLED@1d4d9f3 · GitHub](https://github.com/wled/WLED/actions/runs/19595204901)

---

<div class="post-metadata">

**Author:** ![Gullwingdmc](https://avatars.discourse-cdn.com/v4/letter/g/278dde/32.png) [@Gullwingdmc](https://wled.discourse.group/u/Gullwingdmc)\
**Post date:** [November 23, 2025, 2:12am UTC](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888/39 "2025-11-23T02:12:32Z")

</div>

Just downloaded your build, and it worked!!! Thank you so much!!

[Previous page](https://wled.discourse.group/t/ledmap-not-displaying-correctly/14888.md?page=1)
