Place Linked Bitmap

A Plugin for Sketch 99+

What is this?

This plugin allows you to take a bitmap file (JPG, PNG, PSD, etc) and place it inside Sketch. “But Sketch can already do that” you might be thinking. It can, but what the plugin adds is the ability to easily update the placed bitmap after it’s been placed, without having to re-place it.

Place a PSD file on an artboard, handle your business in Sketch, then maybe switch to Photoshop to tweak the PSD, then return to Sketch, run the “Update All Bitmaps…” command, and your placed PSD has the changes you just made.

But wait, there’s more…

If you don’t use Photoshop (or Pixelmator, or Acorn, or etc), I envy you. But you still might want to give this a try, and here’s why:

As of Sketch 3.4, an artboard can’t be turned into a symbol. You can, of course, export an artboard as a bitmap. So export the artboard and place the bitmap of the artboard in your .sketch file. Then, after you edit and re-export the original artboard, “Update All Bitmaps…”

So How Does This Work?

Either open an existing .sketch file or create a new one (be sure to save the new document somewhere first). To place a bitmap, you have two options:

1. Place Bitmap as New Layer… will create a new bitmap layer with the contents of the bitmap file
2. Place Bitmap as Layer Fill… will place the contents of the bitmap file as an image fill on a selected shape layer [great for avatars and hero images that mimic CSS background-fills]

When one of your bitmap files has been updated, run the “Update All Bitmaps…” command.

For Best Results

If you roll solo, like I do, you don’t have too much to worry about. But if you’re part of a team, with lots of people touching the .sketch files, I have two recommendations:

1. keep your placed assets in the same directory as your .sketch file, or in a subdirectory of the directory in which your .sketch file lives.
2. or, if your team works off a file server, keep your placed assets on that server. [Because, theoretically, the paths to the files will be the same for every person who uses that server.]

Frequently Asked Questions

1. Can I place Photoshop files? Yes! That’s actually why I created the plug-in.
2. What about vector files? Sort of. You can do it, but they’ll be rendered as bitmaps, meaning the image can’t be scaled up.
3. Okay, what about... a .sketch file? That would be interesting, but no, that won’t work.
4. If I move a bitmap file to a different folder, can I still update it in Sketch? Not at the moment, no. I’m looking into it.
5. If I move a placed bitmap from one artboard to another, will it still update? Yes.
6. What about from one document to another? Maybe. If both .sketch files are in the same folder, definitely. If they’re not...
7. If I copy a placed bitmap from one artboard and paste it into another artboard, will it still update? Yes, they both will update.
8. If the size of my bitmap changes, will the size of the placed bitmap change, too? Right now, the size of the bitmap layer won’t change. I’m still thinking of ways to make it smarter, based on complicated math and dumb luck. But I don’t have a solution yet.
9. Is there any way to have the plugin automatically update a bitmap after it’s changed, like Adobe’s apps can? At the moment, Sketch plugins can only run when you tell them to. I’ve heard Bohemian Coding might be looking into other events to trigger plugins, but until then, the answer is no, unfortunately.
10. I already have a bunch of placed bitmaps in my .sketch file. Will the plugin update them for me? That would be great, but no. Bitmaps have to be placed by the plugin, so that the plugin can store location of the bitmap file.

Roadmap

• a way to “relink” and/or “replace” a bitmap
• a way to “unlink” a bitmap

Version History

• 1.99.1
  • Fixes image fills not updating.
• 1.99.0
  • updates for Sketch 99.
• 1.77.0
  • updates for Sketch 77.
• 1.72.0
  • updates for Sketch 72.
• 1.52.0
  • updates for Sketch 52.
• 1.51.0
  • updates for Sketch 51.
• 1.50.0
  • updates for Sketch 50.
• 1.47.1
  • bug fix for Sketch 47.
• 1.43.5
  • Support for Sketch 45’s plugin auto-updating.
• 1.43.2
  • compatible with Sketch 43.
• 1.39.2
  • compatible with Sketch 39 & Sketch 40 beta.
• 1.39.1
  • updated for Sketch 39. Don’t update if you’re sticking with Sketch 3.8.
• 0.9.3
  • updated for Sketch 3.8.
• 0.9.2
  • Place Bitmap as New Layer… can now select multiple bitmap files at one time to place as multiple layers
  • fixes for Sketch 3.5
• 0.9.1
  • Removed support for the Mac App Store version of Sketch.
  • preserve dimensions for bitmap layers with strange DPIs. (fixes #1)
• 0.9
  • Initial release / Public beta

---

Who?

I’m Frank Kolodziej, a Wichita, KS-based freelance designer & developer. I am available for hire. I’m @frankko on Twitter.

Other Plugins

• ★ Utility Belt: An always-expanding collection of simple, focused plugins for Sketch.
• Artboard Tools: Plugins for arranging artboards and navigating between artboards.