You can access versions of a screen by clicking the hourglass button on the bottom left. Every version of artboards you export to Zeplin will be stored separately with commit messages, organized by colors, timestamps.

The topmost version on the list is the latest version and this version is always visible in your project Dashboard. You can quickly check out an earlier version by simply clicking on it or by using the arrow keys.

Versions have a few properties you can (and probably should!) manage.

Commit messages

In one sentence, commit messages answer the following question: “What has changed in the version?”.

Developers have been working with commit messages for years. When they push a change to a codebase, they’re required to provide one. We decided to follow a very similar pattern in Zeplin as well.

Commit messages are different than casual notes or descriptions. You’re not required to follow these patterns at all, but here are few tips and tricks to get the most out of them:

  • Stick to one style: Use the “imperative mood” for simplicity. e.g. change, not changing, remove, not removed.

  • Be precise: Provide specific information so your colleagues can easily figure out what to look out for.

  • Keep it simple: If you feel like you need to explain something in detail, prefer using the screen description section on the right panel.

Here are a few examples:


Similar to notes, you can organize your versions using colors as well. The way to use them is totally up to you and your team’s creativity, but here are a few examples to guide you:

  • Assign colors based on the importance of the changes. e.g. Red for Major, Yellow for Minor, Blue for Asset Change and so on.

  • Assign colors based on states. e.g. Red for Experiment, Orange for In Review, Green for Approved and so on.

Every screen version has a unique link to share with your teammates. You can hover over a specific version and click on the “...” button to copy the Web Link or App URI.

Did this answer your question?