Hi guys! We have an issue and we need your help 🙏🏻
We have a file (File A) saved as a library, where we have built all our components. Most of these components contain nested components with their own properties.
For example, our button component (in all its states) contains a nested component called Button size, where we have defined three sizes (S/M/L) and created properties to change the text value, remove icons, and swap them.
Everything worked perfectly: we linked the library (File A) to File B, where we design our interfaces. The first time we inserted the buttons into File B, everything functioned correctly. From the right panel, we could modify all the button properties, including the nested Button size component.
However, after updating the library (File A) by adding new components (without making any changes to the button component or Button size), we noticed that in File B, after accepting the library update, the buttons broke:
- The label disappeared entirely.
- In some cases, the default "placeholder" label from the library reappeared.
- Both icons reappeared, even when they had been turned off.
- The nested properties of Button size disappeared from the right panel.
We have used only Figma’s native features, without any plugins—just variables and variants.
We would love to understand:
- Why does this issue occur after a library update, even though we did not modify existing components?
- What are the best practices to prevent this from happening in the future?
- Is there a way to "repair" the broken components in our design file without having to manually reapply all the customizations?
- What exactly causes Figma to reset nested properties and overrides in this case?
Any help or insights would be greatly appreciated!
Thanks a lot!
