Updating my design system keeps unlinking some components. Any fix?

Hi everyone,
I’m a design systems designer and I’ve been facing a recurring issue with Sketch. Every time I update my design system library, I notice that some components in my files get detached from the library and turn into local symbols.

I’m trying to understand:

  • Why does this happen?

  • Is there a known fix or best practice to prevent this?

  • What steps can I take to ensure components stay linked after a library update?

Any insights or tips would be greatly appreciated. Thanks!

1 Like

Hi @Shim, and welcome to the forum!

After reading your case, we’ve taken the liberty of moving this topic into the Share an issue section, hope you don’t mind.

It looks like something unexpected happens when you update your design system, so I’d like to know more about your update process.

When you update your design system, do you work directly on the Libraries by editing their Components, or do you create copies of your Symbol sources or documents to generate new ones? If so, that could explain how some instances get detached in the documents linked to the Libraries, and you might need to replace the Components or even the entire Library if a new one was created.

If that’s not the case and we’re talking about straight-up edits on the Components of your Libraries, this could be a potential bug we’d like to study. In that case, could you share your Libraries with us and a sample document we can test? You can write to us at productsupport@sketch.com and attach the files there.