Let’s Add Manual Mapping for Unmatched Tokens in the Swap Library Tool!

Hey folks! :wave:

I was using Figma’s Swap Library feature recently and came across a little hiccup that I think could use some improvement. You know how it works: when you swap libraries, Figma tries to match styles between the old and new library based on the token names, right?

image

But… when there’s a name change or a slight difference in naming conventions, it just says “None found,” and that’s it. :sweat_smile: You’re left with elements still tied to the old library, which can be a bit frustrating, especially when you’ve spent time updating your naming structure to make things more organized or meaningful.

What’s the Ask?

Can we get an option to manually map these “None found” tokens to styles in the new library?

Why This Matters

This would be super handy for situations like:

  • You’ve changed alpha/black/20 to opacity/black/20 in the new library. Sure, the names are different, but it’s still essentially the same style! Being able to manually link these would save so much hassle.
  • You renamed bg/primary to bg/main—again, it’s just a naming update, but Figma doesn’t know that. So, we’re stuck with elements still referencing the old style. :smiling_face_with_tear:

How It Could Work

For any unmatched tokens during the swap, I’m thinking there could be a dropdown or some kind of selection tool where we can manually assign a new style from the updated library. This way, no more lingering connections to the old library, and everything gets updated smoothly!

The Benefits?

  • More Control: Easily resolve mismatches due to name changes without needing to go back and rename all your tokens again.
  • Faster Migration: Skip the manual process of updating each element after the swap.
  • Cleaner Transitions: No more “None found” frustration—get all your elements synced with the new library properly.

What do you all think? Would this be helpful for your projects too? I’d love to hear your feedback and see if anyone else has run into the same situation!

Cheers! :sparkles: