Zeplin uses SketchTool to export the data and the images out of Sketch. This tool does have certain known issues that you should watch out for. 🕵️‍♀️ We're already in touch with the Sketch team and will keep this list updated as they are fixed!

Make sure to try exporting again if you run into an issue, and if it continues, check if it matches any of the known issues below.

If you're having network issues while uploading, like timeouts or bad request errors, check out our Fixing connectivity issues article instead.

Emojis

Text layers with emojis occasionally cause an error: “Dumping your Sketch document's contents failed with an unusual error.”

Try recreating the text layer with the emoji or simply remove the emoji to see if that helps.

If the text layer is emoji-only, its font might be set to “Apple Color Emoji”. Try changing the font to any other font and export again, this won't change the appearance of the layer.

Large artboards or layers

If you have artboards or exportable layers that are too large, you might encounter an error: “Exporting image failed with an unusual error.”

This usually happens when you're exporting a large artboard that has multiple screens in it. You can either export those screens separately or you could try dividing the large artboard into multiple artboards.

Invisible lines

Certain invisible lines in your vector elements might cause an error: “Exporting image failed with an unusual error.”

This occasionally happens on vectors you bring in from other apps, like Illustrator. Deleting these layers should fix the issue.

Missing libraries

If you have a library enabled that is not stored locally on your machine, you might encounter an error: “Extracting Sketch document and library documents failed with an unusual error.” or “Copying filename to a temporary directory failed.️ Make sure that you have access to the file or try disabling unused libraries.”

This usually happens when you're exporting a file that has a library enabled that is not stored locally on your machine and Zeplin can't access it. Make sure that all of the libraries you enabled are accessible by Zeplin—you can also try opening the library file in Sketch first, making sure that it's stored locally and then export the original file to Zeplin.

Others

If none of these solve the issue, there's another workaround you can try: Copy the artboard, paste it in a new Sketch document and try exporting it from there.


Hope these help, let us know if you're still having an issue!

Did this answer your question?