- Introduction to Balsamiq Wireframes for Jira
- Editor Overview
- Adding and Arranging UI Controls
- Editing UI Controls
- Sharing and Reviewing
- Collaborative Editing
- Using Images, Assets, and Icons
- Adding Images in Wireframes View
- Adding Images in Assets View
- Splitting Images
- Extracting Text from an Image
- Adding Non-Image Assets
- Managing Images and Other Assets
- Adding Icons via the UI Library and Quick Add
- Adding and Swapping Icons via the Property Inspector
- Adding Your Own Icons
- Best Practices for Creating or Preparing Custom Icons
- Linking Wireframes Together
- Full Screen Presentation Mode
- Keeping Projects Clean and Organized
- Keyboard Shortcuts
- Balsamiq Wireframes for Jira Admin Guide
- Real-Time Collaboration Service Configuration
- Migrating from Jira DC or Server to Jira Cloud
Using Images, Assets, and Icons
There are multiple ways to add images and icons to your wireframes. The easiest way is to simply drag and drop an image file from your computer on to the wireframes canvas.
But be aware that adding a lot of images - or a small number of very large images - to your project can reduce the efficiency of your project.
As a low-fidelity tool, large images can be slower to load, use more disk space and increase the size of project files. Very large images can cause handling problems when editing. When adding images to your project, we may reduce the size of images in various ways:
- Resize the image to a maximum of 2 megapixels
- Down-scale Retina images from 2x to 1x
- Down-scale HiDPI images
- Convert PNG images to JPG when possible
Note: The image file formats supported are PNG, JPG/JPEG and GIF.
Read on to learn more about adding and using images, icons, and other assets to your projects.
Adding Images in Wireframes View
As mentioned above, dragging an image from your computer to the editor will add it to the canvas. Doing this will place the image into the selected wireframe and copy the image file to your Assets so that you can easily reuse it in other wireframes.
You can modify the image properties in the Property Inspector, similar to other UI controls.
The properties specific to images are as follows:
- The drop-down box shows you the name of the current image. Opening it allows you to select a different image from the images you've already imported to your Assets.
- The "+" icon next to the drop-down box allows you to add an image from your computer. This is the same as dragging and dropping an image file.
- Clicking the cloud opens a dialog to add image from the web by entering a URL directly or by searching Flickr. Wireframes supports GIF, JPG/JPEG, and PNG image file formats. Files downloaded from the web will be copied to your project.
- Click the rotate icon below the image drop-down to rotate your image in 90-degree increments.
- Clicking the square with an 'x' inside it will revert the image to the default placeholder image.
- The "Sketch it!" checkbox will convert your image to a black and white line drawing version.
If you don't yet have an image ready or want to use a placeholder image to keep your wireframe low-fidelity, you can add an Image control from the UI Library and it will show up as a box with an 'X' through it. You can later replace it with an image using the image properties described above.
Once an image has been added to your project it will show up in the UI Library so that you can easily add it to any wireframe in your project. The "Assets" category will show all of the images that you've added to your project.
This also means that you can add your images to your wireframes from the Quick Add box. Just type the first few letters of the image name and it will appear in the list.
The image properties panel also allows you to crop or mask images to only show a selected portion of them. You can watch a tutorial on cropping images here. Images that have been cropped will show an icon to remove the cropping in the properties panel.
Aside from the Image control, you can also embed images in the Cover Flow control.
Adding Images in Assets View
Balsamiq Wireframes has a dedicated area of the user interface for managing images, icons and other assets called the Assets view.
The Assets view shows all images and custom icons that have been added to your project. You can get to it via the View menu.
You can add images in the Assets view by dragging and dropping from your computer or by using the icons in the toolbar.
The "Import Asset..." icon allows you to select one or more images from your computer while the "Download Asset..." icon brings up the same dialog as in the wireframes view to enter an image URL or search for an image from Flickr.
Once you've added images, you can view them as thumbnails or a list, as well as in Thumbnail Grid view.
The Property Inspector on the right shows you the pixel dimensions of the selected image and allows you to enter notes about it. The lower portion of the panel shows which wireframes (if any) the image is used in. This can be used for managing images to see if you can delete any that aren't being used, for example. Clicking on a wireframe name will take you to that wireframe in the wireframes view.
Images can be split horizontally using the Split Image button in the Property Inspector.
When you press the Split Image button, a horizontal bar will appear on the image, which you can drag to where you want the split point to be. Once you have placed the bar where you'd like it, clicking Split Image on the floating toolbar will split the image at the bar's location.
Extracting Text from an Image
Note: Extract Text is still in beta and should work fine with most latin-based languages. However, because it needs to talk to our servers to function, it is not available for our Atlassian Server and Data Center integrations.
You can also extract text from an image using the Extract Text button in the Property Inspector.
Extracting the text will create a new image with the text removed and your text in text controls on top of it. Here is how it looks in action:
Note: When using Balsamiq Wireframes for Desktop, extract text is only available if you have an active internet connection, and have associated a Balsamiq Cloud account with your desktop installation. Balsamiq Cloud accounts are free. You can sign up for an account here.
Adding Non-Image Assets
You can also store other types of files in your project that won't be used in your wireframes, such as requirements documents, Photoshop or Illustrator files, PDFs, or any other file that's associated with the project. We call these "non-image assets" and they can be added to your project by dragging them into the Assets view, just like images. Common file types (zip, pdf, doc, etc.) will be shown with an appropriate logo. Other files will show a generic document icon.
Note: Assets are limited to 20 Megabytes per file for performance reasons.
These files can't be viewed inside the application, but they are "packaged" with your project, so if you give the project file to someone else they will be able to save the files from the Balsamiq project to their computer using the "Save to disk" button or context menu item.
Managing Images and Other Assets
As with the wireframes view, the Assets view has a context menu that you can open by right-clicking in the navigator or using the drop-down arrow. This allows you to rename, cut, copy, download, update or delete your images and other assets.
Renaming assets using the context menu will change the name of the asset in your project. It will not affect the original file, as the asset is a copy that has been added to your project. Renamed images will get updated in your wireframes, so you don't need to update them manually.
Saving Assets from Your Project to Your Computer
You can get assets from your project on to your computer by using the "Save to Disk" option in the context menu, allowing you to extract assets from your project for other uses.
Replacing or Updating Assets
The "Import New Version..." menu option allows you to select a new asset to replace the selected asset with. This is useful if you want to update an image that is already in use in your wireframes, for example. The new version will then be used anywhere the selected image was used.
You can also use the context menu to delete assets from your project. Just like your wireframes, deleting will move assets to the Trash, where you can delete them permanently or restore them.
Note: You can also empty the Trash directly from the dedicated toast message.
Select Unused Images
Another option allows you to select all images that are not used in your wireframes. The option is available in the Edit menu, as shown below:
Selecting it will open the Assets view where all the unused images will be selected for you. You can then delete them as explained above, via the dedicated toast message or the context menu. This is a great way to reduce your project's file size.
Adding Icons via the UI Library and Quick Add
Icons from the amazing Font Awesome icon set are pre-installed. It contains over 500 icons in a wide range of categories that can be sized from very small to very large. It is also updated frequently and we plan to keep up with the updates whenever we release a new version of our product.
Icons have their own category in the UI Library so you can drag and drop them just like any other control.
Not only that, they also show up in the Quick Add results, saving you time when searching by name or keyword.
Icon search results are shown below any UI controls that match the text you enter.
Adding and Swapping Icons via the Property Inspector
Some controls allow you to add icons to them (buttons, for example). You can do this from the Property Inspector in one of two ways: the icon search and the icon library dialog.
If the control you selected support icons, you will see the icon search box in the Property Inspector. This works much like the Quick Add tool, just type a few letters from the name of the icon you are looking for and a list of suggestions will pop up as a grid of icons to choose from. Just click on the one you want to select it.
You can then size the icon from "XS" (16px) to "XXL" (128px). You can also rotate icons in 90 degree increments using the button next to the search box.
The Icon Library Dialog
If you'd like to explore all the icons that are available, click on the icon to the right of the icon search box.
This will bring up the icon library dialog, where you can browse the icons by category and preview them at different sizes. You can double-click an icon to select it immediately or click once to select and then click the "Select" button to add it.
Once you have selected an icon, you can resize it, rotate it or remove it via the Property Inspector.
Adding Your Own Icons
You can also easily add your own icons for use in your wireframes by selecting any of your imported images, and using them as an icon. They will automatically show up in the icon library, under the Assets category at the bottom.
Best Practices for Creating or Preparing Custom Icons
The editor recognizes color and transparency, but icons you add may not turn out looking as you want them to if they're not prepared the way we expect. Below are some tips to get the most out of your custom icons.
- Wireframes uses black as a color for replacement at 100% opacity.
- Icons that aren't created with black can have undesirable effects when colorized.
- We recommend using black as the color for your icons.
- Wireframes colorizes the entire opaque area of the icon.
- For best results, we recommend knocking out "white" areas of your icon using transparency. Transparent PNG works best.
The example below shows regular icons in the left column, a custom icon properly prepared with black fills in the middle column, and a custom icon that doesn't work as well in the right column. To fix the icon in the right column, the exclamation point should be made transparent, and the icon color should be black.
- Collaborative Editing