Balsamiq for Desktop Docs > Working with Alternates
Alternates (also sometimes referred to as versions or branches) allow you to create variations on a single mockup design without adding more mockups to your project.
Creating alternates can be useful during the early design phase when exploring concepts and in later stages for reviewers to add their feedback and propose changes.
Some possible reasons for using alternates:
Here's an overview:
When viewing a mockup without any controls selected you will see a section of the Property Inspector panel called "Alternate Versions" below the notes for that mockup.
To create a new alternate click the "+" (plus) icon next to "Alternate Versions"
or use the context menu in the Navigator panel.
This will create a copy of the current mockup as an alternate version for you to modify. By default it will automatically be named with the word "Alternate" followed by some random numbers and letters to ensure that the name is unique.
The selection in the alternate versions list tells you which version of the mockup you are working on. You can create as many alternates as you'd like.
Note: You can create an alternate of an alternate. Clicking the "+" (plus) icon when an alternate is selected creates an alternate of the selected version rather than the official version.
When an alternate exists an icon will appear next to the name in the Navigator panel indicating that there are alternates. When you are working on an alternate version the Navigator panel will show the alternate name in parentheses.
To rename the alternate double-click on the name in the alternates versions list or use the context or right-click menu and select "Rename..."
Once you have created an alternate version you can edit it just like any other mockup, including adding assets and symbols. Changes that you make will not affect the original mockup (shown as the Official Version). You can also add notes in the notes panel for the alternate to describe your thoughts on it or communicate to others about it.
To switch between alternate versions of a mockup select the name of a version from the list in the properties panel or from the context menu in the Navigator panel. You may also switch back to the Official Version by selecting it in the list.
Note: If you link to a mockup that contains an alternate the link will go to the version of the mockup that is selected in the alternates list. The same rule applies to exporting. The selected versions of your mockups will be exported.
If you decide that you like one alternate better than the original mockup you can "promote" it to the official version, which replaces and overwrites the original.
Note: You can undo this action by using the undo command (CTRL/CMD+Z) three times.
The alternate that was promoted is retained in case you want to preserve it as part of the change history. Otherwise you can discard it.
You can duplicate mockups from the contextual menu. Doing this will create a new, randomly named alternate that is an exact copy of the alternate you chose to duplicate.
Sometimes, however, an alternate grows into a mockup all its own. If you would like to create a whole new mockup based on an alternate, you can choose the "Duplicate As New Mockup" option from the contextual menu.
The new mockup will be named using the Name of the Alternate and then the Name of the Original Mockup. So if you had an alternate named "Rotated Header", in your "Homepage" mockup, the mockup created from the alternate would be named "Rotated Header Homepage".
If you want to combine parts of an alternate with the official version, you can use the merge option.
Selecting "Merge with Official" will add the contents of the selected version to the official version, to the right of the mockup contents, as shown below.
If the notes in the alternate are different than the notes in the original, they will also be merged, separated by a dashed horizontal line.
You can then manually edit the contents to create a new official version that is a combination of the preferred elements of each version.
When you have finished reviewing or integrating alternate versions into an official version you can delete alternates you no longer want using the "Discard" option.
Note: Alternates cannot be recovered after they have been discarded.
You can view your alternates in Full Screen Presentation Mode by using the navigator dropdown.
When you select a mockup alternate in this view, its name will show up in parentheses next to the official mockup name.
In some cases you might want to propose a set of alternate designs across several mockups. This might happen if you are reviewing someone else's mockups and want them to see your proposed design changes throughout the project.
When you rename an alternate you can choose from a list of existing alternate names in the rename dialog. This makes it easy to use the same alternate name in several mockups.
In the Navigator panel next to the word Mockups a menu shows the names of all alternates that appear in your project.
Selecting an alternate from this list will select that alternate in all the mockups that have an alternate with that name.
Note: This is conceptually similar to creating a branch in a codebase, except that it only applies to mockups that have specific alternate version names.
So, for example, if you create a series of alternates called "Leon's Proposal" and use the context menu shown above to select that name, any mockup with an alternate called "Leon's Proposal" would switch views to that alternate version.
Mockups without an alternate with that name would not be updated. Promoting, merging, and discarding actions are not available across multiple mockups at once.