Introduction to Balsamiq Wireframes for Confluence Cloud
Using Confluence Server? If you are hosting Confluence behind the firewall, please see this article instead.
Confluence Cloud Administrators: the Balsamiq Wireframes for Confluence Cloud Admin Guide is for you.
Balsamiq Wireframes for Confluence Cloud provides very similar functionality to Balsamiq Mockups 3 for Desktop.
The main difference is that the Balsamiq project files are stored and managed as Confluence Cloud attachments.
Note: This video shows an older version of the Confluence interface. Thanks for your patience while we update it.
Adding a New Project to a Confluence Page
Adding a new Balsamiq Wireframes project to a wiki page is very similar to adding an image.
Edit the page, position the cursor where you’d like your wireframes to be, then press / followed by the first letters of Balsamiq (or Wireframes) and select the "Balsamiq Wireframes" macro from the list.
Note: For existing Confluence users that still have the older Confluence User Interface, the macro can be added from the Insert menu (+) by selecting “Balsamiq Wireframes” from the list.
The link will launch the Balsamiq Wireframes editor to allow you to create your wireframes (or import existing ones). This will also create a new Balsamiq Wireframes file (.bmpr file extension) attached to your Confluence page containing all the resources that belong to a project (wireframes, symbols, images, icons).
If you do not see the macro listed, please check with your Confluence administrator that the Balsamiq Wireframes for Confluence Cloud app is installed and that you have editing permission on the current page.
Alternatively, you can instead use an Image Link from a wireframe that you have already created. More details on this page.
Using the Balsamiq Wireframes Editor
The Balsamiq Wireframes editor allows you to create wireframes just like our other products. Start with the application overview to learn more about using the editor.
Collaborating with Other Users in Real Time
Balsamiq Wireframes for Confluence Cloud supports real-time collaboration between users: just have everyone launch the editor on the same project. Everyone’s changes will be shared in real-time with all collaborators.
The other connected users will be shown in the top right of the screen. Hovering over their picture shows their Confluence username.
Copying or Moving Wireframes between Projects
Sometimes you might want to copy or move a wireframe (or a few) from one project to another. Here is a simple way to do it:
- Open the two projects (each in its own browser tab or window)
- In the source project, select the wireframe(s) you want to copy or move
- Copy the wireframe(s) (CTRL/⌘+C)
- In the target project, paste your wireframe(s) (CTRL/⌘+V)
That’s it! You may now delete the wireframe(s) from the source project if you wish.
This simple method works across all our Balsamiq Wireframes products.
Note: Symbols and Assets/Images are also transferred during this process so no need to worry about those.
Importing from Other Versions of Balsamiq
If you have a project created in another Balsamiq product (using the .bmpr extension), the easiest way to import it is to create a new project and use the Project > Import > Import from BMPR option.
Exporting to Other Versions of Balsamiq
To export your project to another Balsamiq product, all you need to do is download it and open it there. Selecting the Project > Export > Download Project BMPR option will create a .bmpr file to download containing all the wireframes, symbols, and images used in the current project.
Saving the Project
All the changes made on your project in the editor are always autosaved and visible by the collaborators that are editing the same project in real time.
However, the changes made in editing mode (i.e. inside the Balsamiq Wireframes editor) will not be flushed to the official version that is attached to the Confluence page until the project is expressly saved.
This can be done by selecting the Project > Save Project option or by simply closing the editor.
Returning to Confluence (Closing the Editor)
When you are done editing your wireframes, you can exit the editor by selecting Project > Exit Back to Confluence.
This will also save the current project and update the version that will be now visible in the Balsamiq Wireframes macro.
Alternatively, you can perform the same action by clicking on the breadcrumb link pointing to the Confluence page containing your BMPR project, on the top-left part of the menu bar.
Using the Balsamiq Wireframes Macro
Once you have created a new project, the Balsamiq Wireframes macro will appear on your Confluence page.
The macro looks like a plain image, but when your mouse is over it, a control bar will appear. The control bar allows you to launch the editor on the selected wireframe, review and comment in Full Screen or get an Image Link.
Editing Existing Wireframes
There are two ways to open the Balsamiq editor:
- Click the “edit” icon next to the wireframe name in the macro:
- Edit the wiki page, enter the macro editor and launch the Balsamiq Wireframes editor:
Note: If you have read-only permission on an page, you will be still able to access the Full Screen viewer but you will not be able to edit the wireframes.
Using the Balsamiq Wireframes Macro Editor
Accessing the Balsamiq Wireframes Macro Editor can be done by editing the wiki page and entering the macro editor, as shown below.
The macro editor lets you configure the Balsamiq project view that will be shown in the Confluence page.
You can chose to show a thumbnail grid or, in case of the single wireframe view, you can configure the starting wireframe, the size and the alignment.
To add multiple views on the same project, just add more macros and select a different starting wireframe for each one.
You can also launch the Balsamiq Wireframes Editor and continue to edit your project from there.