// troubleshooting guide · penpot
Penpot 2.0 Broke My Designs
- Status
- Fixed in latest version
- platforms:
- Web
- updated:
- November 15, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · penpot/flex-layout-broke-after-2-02 FIXES
// quick answer
2.0 changed flex layout z-order to match HTML. Move background fills onto the flex layer itself.
Most likely fix: Fix background layers
How to fix it
// try these in order, the most common fix is first
FIX 1Fix background layers
- 01Select the flex layout board
- 02Set the fill on the board instead of a child background layer
Did this fix it?FIX 2Check components
- 01Review migrated components and overrides
- 02Re-sync main components
Did this fix it?
Symptoms
Layers inside flex layouts look different or hidden after upgrading.
Why it happens
- C-01Flex layout z-order changed to HTML behavior
- C-02Component system migration
// this guide also covers
- penpot 2.0 broke designs
- penpot flex layout z-index
Still not working?
If Penpot keeps failing, you're not alone. See every Penpot problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us