medium bookmark / Raindrop.io |




Replace symbols in the current document with symbols from a Library.

Sketch 47 sees the introduction of Libraries, but migrating existing files to use Library symbols is one of the first big headaches. This plugin aims to help with that by allowing you to replace symbols in the current document with symbols from a Library document – maintaining overrides where possible.

N.B. the plugin currently uses symbol name to work out what to replace with what, so be careful of any conflicts.


Download, unzip and double click the .sketchplugin




Using the plugin

  • Open a document where you want to replace symbols with Library symbols
  • Run the plugin from Plugins > Library Symbol Replacer > Replace symbols from Library
  • Select the Library file using the Choose dialog
  • The plugin will tell you what replacements it thinks it can make
  • When the replacements are done, it will also ask you if you want to delete the symbols which have been replaced

Breaking up a big file

  • If you’re breaking up a big file, copy and paste some symbols into a different Sketch document
  • Make that document a Library (see Sketch docs if you need help)
  • Repeat this into as many Libraries as you want
  • In your original file, use the plugin to replace your document symbols with the new Library ones


  • It is currently quite dumb and just uses symbol names to match symbols – that’s because symbol IDs can be different, depending on how you copy and paste thing around
  • Hopefully the overrides should be fairly resilient, but there are a few Sketch bugs I came across while implementing this, so I had to work around those
  • It won’t work for replacing Library symbols with other Library symbols – this could be a future improvement


Get in touch at robin#zeroheight.com, but use @ instead of # if you’re not a 🤖


Copyright (c) 2017 Zero Height Limited (zeroheight). See LICENSE.md for further details.

Featured articles on Prototypr: