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 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 try dividing the large artboard into multiple artboards. See the sample large artboard below:

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.

If you have some layers which names are “object” instead of “string”, you might encounter an error: “Exporting artboards failed with an unusual error”

You can rename all of these layers as string names and then try to export the file again.

Zeplin exports document colors or colors set up in layer styles from Sketch. If you don’t set your colors as document colors or layer style colors in your Sketch file, you might encounter an error while trying to export colors: “Exporting colors failed, no colors found in Sketch document”

You can set up color variables and layer styles from the right panel in Sketch, as shown below, and then try to export them again.

If none of these solves the issue, there's another workaround you can try:

Hope these help! If you're still having an issue, you can contact us at support@zeplin.io.