Skip to main content
Question

Best approach for replacing legacy components in an existing Figma library

  • March 6, 2026
  • 0 replies
  • 8 views

magda gdansk

Hi everyone,

I’m facing a challenge with our current Figma component library. Some of the existing components were built without Auto Layout or have an inconsistent internal structure, which makes them difficult to maintain and scale.

I’m planning to redesign and improve some of these components (mainly restructuring them and introducing Auto Layout). However, the updated versions would have a slightly different internal architecture compared to the original ones.

My concern is how to replace the old components with the new ones without breaking or heavily impacting the designs that already use the existing instances across multiple files.

What would be the best approach in this situation?

  • Should I try to preserve layer naming and structure to allow swapping?

  • Is it better to introduce a new component version and migrate gradually?

  • Are there any recommended workflows or best practices for handling this in an established design system?

I’d really appreciate any advice or experiences with similar situations.