// troubleshooting guide · penpot
Penpot Variants Not Working
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 15, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · penpot/variants-not-working3 FIXES
// quick answer
Use the variants feature in 2.x; the old slash-name workaround is for older files.
Most likely fix: Update Penpot
How to fix it
// try these in order, the most common fix is first
FIX 1Update Penpot
- 01Use a version with variants (2.11 added multi-switch)
- 02Self-hosters: upgrade carefully
Did this fix it?FIX 2Use the variants workflow
- 01Create a component, then add variants via the variant button
- 02Switch several copies at once
Did this fix it?FIX 3Legacy workaround
- 01Name components Group/Name using slashes
Did this fix it?
Symptoms
You cannot find variants or switching does not sync.
Why it happens
- C-01Old version without variants
- C-02Overrides not synced
// this guide also covers
- penpot variants
- penpot component variants
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