User Manual for Gliffy Confluence Plugin

Gliffy is designed to make it easy and intuitive for you to create professional quality flowcharts, diagrams, floor plans, technical drawings and more. While it’s easy to figure out Gliffy on your own, this guide addresses the basics of using Gliffy and will also help you use some of our more advanced features.

 

Table of Contents

Installing the Gliffy Confluence Plugin

Adding Gliffy Diagrams to Confluence

The Gliffy Editor

Working with Shapes and Lines

Gliffy Basics

Keyboard Shortcuts

Context Menu

Gliffy Diagrams on the Attachments Page

Hyperlink Navigator

 

Installing the Gliffy Confluence Plugin

back to top

 

Automated Installation

  1. In Confluence, open the Adminstration  menu and select Confluence Admin.
  2. Log in with your Confluence credentials.
  3. In the left menu, select Find New Add-ons to open your Universal Plugin Manager (UPM).
  4. Search the Marketplace for Gliffy.
  5. Click Install.

If you are not already a Gliffy customer, you will start a free 45-day trial. Before your trial expires, be sure to purchase a license.

back to top

 

Manual Installation

  1. Get the Gliffy Confluence Plugin JAR/OBR file on our download page.
  2. In Confluence, open the Administration  menu and select Confluence Admin.
  3. Log in with your Confluence credentials.
  4. In the left menu, select Manage Add-ons.
  5. Select Upload Add-on.
  6. Browse your computer for the Gliffy Confluence Plugin JAR/OBR you downloaded in step 1 and click Upload.
  7. The plugin will be uploaded to Confluence and will be automatically installed. Check the Manage Add-ons screen to ensure that the plugin is available.

If you are not already a Gliffy customer, you will start a free 45-day trial. Before your trial expires, be sure to purchase a license.

back to top

 

Updating the Gliffy Confluence Plugin

As long as you have an active Gliffy license, you can update the Plugin any time from the Universal Plugin Manager (UPM):

  1. In Confluence, open the Administration  menu and select Confluence Admin.
  2. Log in with your Confluence credentials.
  3. In the left menu, select Manage Add-ons to open your Universal Plugin Manager (UPM).
  4. Under Available Updates you will see if Gliffy can be updated.
  5. Click on Gliffy then click the Update button.

If your Gliffy license has expired, you will need to renew your license before you can install the update.

back to top

 

Gliffy Plugin Administration

In the newer versions of Confluence (5.x), users with Admin access can access the Gliffy Confluence Plugin area by going to the  button->Add-Ons->Manage Add-Ons->Gliffy Confluence Plugin. Here you can locate and update your license information.  

 

In older versions of Confluence, users with Admin access can access the Gliffy Plugin Administration by going to the  button->Confluence Admin->Gliffy Plugin Administration located on the left side. Here you can adjust settings and locate license information.  

back to top

 

Locating Your Customer ID

You must be a Confluence administrator to access your Gliffy customer ID:

  1. In Confluence, open the Administration  menu and select Confluence Admin.
  2. Log in with your Confluence credentials.
  3. In the left menu, select Gliffy Plugin Administration.
  4. Scroll down to Support and locate your Customer ID.

back to top

 

Setting Your Language Preference

 

In Gliffy Confluence Plugin version 5.4 and above, you can set your Language Preference from the Confluence login page, and your language will follow you throughout Gliffy. All of Gliffy's labels will now be viewable in the language of your choice. You can choose from: 

  • German
  • English
  • French
  • Swedish*
  • Dutch*
  • Finnish*
  • Norwegian*
  • Japanese*
  • Russian*

Simply select the language preference at the bottom of the Confluence login page. 

 

 

The language preference you set in Confluence will now auto-translate for you all throughout Gliffy. 


*For Swedish, Dutch, Finnish, Norwegian, Japanese and Russian languages, you will need to install the appropriate Confluence Language pack: https://confluence.atlassian.com/display/DOC/Installing+a+Language+Pack

 

back to top

 

Adding Gliffy Diagrams to Confluence

back to top

 

Access the Gliffy Start Screen

The Gliffy Start Screen dialog lets you add diagrams to your pages. There are three ways to access the Gliffy Start Screen:

  1. While editing a wiki page, go to Insert -> Gliffy Diagram.
  2. If you are editing a page and prefer keyboard shortcuts, type the macro, “{gliffy”.

 

3. You can use the Blueprint feature to start a new blank page with a Gliffy diagram. To access this click the   button at the top of any Confluence page. A window will open and you can select "Add a blank page with a Gliffy Diagram". 

 

You can also use the Blueprint feature to add or customise templates for a selected space. 

Clicking on that link will bring you out to the Space Templates in Confluence. Click on "Add New Space Template" and this will start a new page for you. 

You can name your Space Template, then select Insert->Gliffy Diagram. Here you can only search for an existing diagram, or use a Gliffy template in your Space Template. Gliffy diagrams cannot be created or edited in templates. If you need to edit a diagram in a template, please edit the diagram from the page where it is attached and changes will be reflected here.

To remove a Space Template, click the "Remove" button. 

 

back to top

 

Create a New Diagram

To create a new blank diagram, select Create a New Diagram from the Gliffy Start Screen, select Blank, then click Create (or just double-click). 

To start a diagram using a Gliffy Template, click into the category you want on the left, then choose the template you want and click Create (or just double-click). 

back to top

 

Import Diagrams

If you have a file ready, you can import an existing Gliffy diagram that has been saved in .gon, .gliffy or .gxml format, or Visio* XML drawings that have been saved as .vdx files:

  1. Open the Gliffy Start Screen.
  2. Select Import a Diagram from the menu.
  3. Click Browse to locate your file.
  4. Double-click on your file to select it. You will then be launched into the Gliffy Editor. 

 

*Please note: Visio import is available in Gliffy for Confluence version 5.4 and above 

back to top

 

Create a New Diagram Based on an Existing Diagram

You can use any diagram that already exists on any page within your Confluence as a starting point for a new diagram:

  1. Open the Gliffy Start Screen.
  2. Select Search for a Diagram from the menu.
  3. Type in the diagram name, select the space in which it was created, and hit Enter on your keyboard to Search.
  4. Select the diagram from the list and click Use as a Template.

 

back to top

 

Insert an Existing Diagram

You can also insert an existing diagram into a new page without creating a new diagram. Note that, in the case of an inserted diagram, if you select the option to Link to Original Diagram, any changes will affect the original diagram and will be reflected anywhere that diagram appears. If you leave this unchecked, it will create a new diagram that is not tied to the original.

To insert an existing diagram into a new page, do the following:

  1. From the page where you would like the diagram to appear, open the Gliffy Start Screen.
  2. On the left side of the Gliffy Start Screen, click Search for a Diagram.
  3. Type in the diagram name, select the space in which it was created, and hit Enter on your keyboard.
  4. Select the diagram from the list and click Insert Diagram.

 

back to top

 

Edit an Existing Diagram

Edit an existing diagram while viewing a Confluence page:

  1. Hover your mouse over the diagram.
  2. Click the Edit button.

 

Edit an existing diagram while editing a Confluence page:

  1. Edit the page in Confluence. 
  2. Select the diagram.
  3. Click the Edit button at the bottom or double-click your mouse on the diagram.
  4. You will then be launched into the Gliffy Editor.

 

 

 

back to top

 

Rename or Delete Diagrams

You can rename or delete any diagram from the Confluence page where it was created. Go to Tools > Attachments to locate your diagram files.

Rename a diagram:

  1. Go to Tools > Attachments.
  2. Locate your diagram in the list. Under Comments, it will be described as GLIFFY DIAGRAM. Click Properties.
  3. Change the File Name and click Save.
  4. Return to the Confluence page. You will see a Gliffy Macro Error where the diagram should be. Edit the page.
  5. Delete the broken macro.
  6. Go to Insert > Gliffy Diagram.
  7. On the left side of the Gliffy Start Screen, click Search for a Diagram.
  8. Select Last Modified from the menu.
  9. Locate your updated diagram name on the list. Select it and click the "Link to Original Diagram" box in the bottom left-hand corner
  10. Click Insert Diagram in bottom right-hand corner

Delete a diagram:

  1. Go to Tools > Attachments.
  2. Locate your diagram in the list. Under Comments, it will be described as GLIFFY DIAGRAM. Click Remove.
  3. You will get a message asking you to confirm the delete. Click Remove again.
  4. Return to the Confluence page. You will see a Gliffy Macro Error where the diagram should be. Edit the page.
  5. Delete the broken macro.

 

back to top

 

Change the Display of a Diagram

Clicking on your diagram in Confluence while in Edit mode will make the Properties Buttons appear at the bottom and allow you to change the way your diagram appears on the page.  

 

  1. Clicking on the Edit button will launch you into the Gliffy Editor. 
  2. Clicking on the various Size buttons will make your diagram appear small, medium, or large on the page. 
  3. Clicking on Original will set the diagram back to its original size 
  4. Clicking Border will create a border around your diagram. 
  5. Clicking More will give you options to manually change the pixel size of your diagram and to show the "Full" Chrome or "None". 
  6. Clicking Remove will remove the diagram from your Confluence page. 

 

back to top

 

The Gliffy Editor

back to top

 

Drawing Canvas

The Drawing Canvas is where you build your documents. Drag shapes from the symbol libraries or create elements using the toolbar to create flowcharts, diagrams, schematics, wireframes, floor plans, or whatever else you desire.

The bottom and side scroll bars help you move around in larger documents. Holding down the spacebar while you click and drag lets you pan around the canvas. And, if you have a mouse with a scroll wheel, you can use that, too!

back to top

 

Tabs

You can open multiple diagrams at once with the tab feature. To open a second diagram, click the + tab, and use the Open Diagram dialog to navigate to your second diagram.

back to top

 

Toolbar

  1. Breadcrumb Trail back to your Confluence page.
  2. Send Feedback to the Gliffy team
  3. Gliffy Help
  4. File options:
    • Open a new diagram
    • Save the current diagram
    • Save and Close the diagram and return to Confluence
    • Close the diagram and return to Confluence
    • Export the diagram as an SVG, Gliffy GON, Gliffy GXML, JPG, or PNG file.
    • Review or revert to previously saved version of the diagram with the Revision History.
    • Set your Document Properties, including width and height, background color, grid display, snap-to-grid placement, and whether to export a border with the diagram.
  5. Common Edit options: Undo/Redo, Select All, Group, Ungroup, Copy, Cut, Paste, and Delete
  6. Edit buttons:
    • Undo
    • Redo
    • Group
    • Ungroup
    • Move to Front
    • Move to Back
  7. Element buttons:
    • Text Tool
    • Ellipse
    • Rectangle
    • Connector
    • Straight Line
    • Pointer
    • Pan
  8. Zoom Buttons
  9. Drawing Guides toggle
  10. Save the diagram, or Exit the diagram and return to Confluence

 

In Gliffy Confluence Plugin version 5.2 and above, the Toolbar now includes the Drawing Guides, Show Grid, and Snap to Grid. In versions below v5.2, the Show Grid and Snap to Grid are still located under File->Document Properties. 

  1. Drawing Guides
  2. Show Grid
  3. Snap-to-Grid

back to top

 

Shape Libraries

To expand any shape library and browse the shapes it contains, click that library tab in the left menu. 

Hover your mouse over any shape to see a brief description. Drag and drop any shape from any library right onto the Drawing Canvas.

 

 

back to top

 

Customizing and Managing the Shape Libraries

In Gliffy for Confluence v6.0 or above, if you do not see the Shape Library you want on the left side of the Drawing Canvas, you can click on More Shapes which will open up the More Shapes dialog and will allow you to customize your shape library. 

 

Clicking on the individual shape library names expands that chosen section to allow browsing the shapes it contains. You can click and select or de-select libraries you want to add or remove.

 

You can also add your own shape libraries by clicking on the +Add Custom Library* button at the top of the More Shapes area. 

*this option is only available on Confluence v4.3.7 and above

 

Once the Custom Library dialog appears you can add your own JPG, PNG, GIF, and SVG files to it. Please keep in mind there is currently a limit of 30 images per library and a limit of 1MB per image

You'll also need to name your custom library before you click Save Library. 

*Please note your library will not save without a name!

 

The Hide Sidebar button is located at the bottom of the symbol library panel, to the left of the drawing canvas and to the right of the "More Shapes" button. It allows you to hide any symbol libraries that you don't want to currently show in the drawing pane.  

 

You can also Expand/Collapse all the libraries to make them easier to navigate. 

 

If you click on the  button in a shape library, you can move the libraries up/down on your list and re-order them as you like. Clicking on the "x" in the shape library title bar will remove it from your library pane. You can bring it back at anytime by going into More Shapes. 

 

To manage your custom shape library, click on the title of it in the sidebar then click on the gear wheel to show the Custom Library Options. Here you can:

  • Edit this Library
  • Remove from Favorites
  • Remove from Sidebar
  • Delete Permanently

back to top

 

Working with Shapes and Lines

You can add shapes to the Drawing Stage in two ways:

  • Draw them with the Ellipse or Rectangle Tool or
  • Drag them in from the Shape Library.

You can draw connectors and lines using the Connector Tool and the Line Tool.

back to top

 

Using the Ellipse and Rectangle Tools

The most basic way to draw shapes is using the Ellipse and Rectangle Tools in the Toolbar . These tools work identically; one draws a shape with rounded corners and the other draws a shape with right angle corners.

There’s no trick to using either tool. Just select the tool you want from the Toolbar and draw by clicking, dragging and releasing. The first place on the Drawing Stage that you click defines the first corner of the shape’s boundary box. As you drag your mouse with the button depressed, the box grows. When you release the mouse button, the ellipse or rectangle is created to fill the boundary box you’ve drawn.

back to top

 

Using the Shape Library

If you’re using shapes from the Shape Library, it’s even easier. First find the shape you want. Next click it then drag it onto the Drawing Stage and drop it at the destination.

back to top

 

Moving and Manipulating Shapes

As explained in Gliffy Basics, any shape can be resized, rotated or moved once it’s been placed upon the Drawing Stage. You can use the little squares that appear in any selected shape’s boundary box’s corners or midpoints to extend the dimensions of the shape. Just click and drag them. To rotate a shape, click and drag the curled arrow that you’ll see above the selected shape.

Also worth noting is the ability to lock a shape to its current dimensions. To do this mark the “Lock Shape” box in the shape’s Properties Panel that appears to the right of the shape. (Using Gliffy Online, you can also right click on a shape and select “Lock Shape” from the context menu.)

When you lock a shape, the little squares around the boundary box turn red to indicate the shape is fixed. You will not be able to change the dimensions, or other properties, of the shape until you unlock the shape.

back to top

 

Setting Shape Properties

When you select a shape, you can edit its properties using the Properties Panel . At the top of the shape properties section, you will see six icons that control the shape’s appearance.

The   icon lets you choose what color fill you want the selected shape to have.

The  icon controls the color of the shape’s border.

The  icon determines how thick the shape’s border is, or whether it has a border at all.

The  icon allows you to turn the gradient on or off and the fill color will transition from lighter to darker from top to bottom.  

The  icon allows you to add shadows to your shapes that suggest depth. 

The  icon allows you to add opacity to Basic and Flowchart shapes

If you find your mouse isn’t giving you the level of control you want, you can also use the Size, Position and Rotation properties to specify the exact dimensions, location and angle of rotation of the selected shape. The position coordinates correspond to the position of the upper left corner of the shape’s boundary box.

On the right side of the Properties Panel, you’ll also see check boxes for “Aspect Ratio" and ”Lock Shape”. Marking the “Aspect Ratio” box forces the selected shape to retain its current shape, but not its size. You can still make an ellipse or rectangle larger or smaller, but it will hold its aspect ratio. “Lock Shape” not only secures the aspect ratio, but also secures the size, color and other properties of the selected shape. 

 

back to top

 

Drawing Guides

Gliffy provides guides to help you line up your shapes with other shapes. To turn on the Drawing Guides, click on the  button in the Toolbar. Now, when you drag a shape from somewhere on the stage or from the shape library, it will detect if another shape in it’s vicinity has a matching edge or center point. If there is a matching edge, the shape you are dragging will “snap” to the other shapes edge, and a green line will appear to show the alignment. The same goes with a center point, except the line will be red. See the image below as an example of a left edge and center point alignment on the X axis.

back to top

 

Using the Connector and Line Tools

The Connector and Line Tools work identically to each other.

The Connector Tool lets you draw a line forced to turn at right angles where necessary and the Line Tool draws a straight line between whichever endpoints you select, with no turns. To draw either a connector or a line, select the appropriate tool from the Toolbar, place your cursor where you want your connector or line to start and click and drag to your desired endpoint.

back to top

 

Moving and Locking Lines and Connectors

Once you’ve drawn a line or connector you’ll notice a characteristic about each endpoint: if it’s a connector with more than two segments, each middle segment has a little circle. These circles work like the squares around the boundary boxes of shapes. If you click and drag on one of the circles, you’ll only adjust that segment of the line/connector. If you click anywhere else, you’ll move the whole line.

Frequently, you’ll want to connect the end of a line to a shape so that if the shape moves, the line will stick to the shape. When you select a line, you’ll see that all the shapes in your diagram become flanked with little ‘ + ‘ symbols. There should be one in the middle of each shape as well. These ‘ + ‘ symbols are standard connection points. If you drag the endpoint of a line or connector to one, you’ll see the little circle turn green. That indicates the line is locked to the connection point. From then on, if you move the shape, the line will remain connected.

When initially drawing a line or connector, you can start off on a connection point—if the connection point shows a green circle, your line will be locked to it.

back to top

 

Infinite Connection Points

You can attach your connectors to any outside border of certain shapes within Gliffy. When you use the Connector Tool and scroll around the outside of certain square shapes, you'll see a green circle appear. The green circle indicated where you can attach it. If you scroll all the way around you will see you can place your connector anywhere and lock it to the shape.

*Please note: If you don't see this option on the shape you are selecting, is is not available yet but will be coming soon. 

 

back to top

 

Setting Line and Connector Properties

When you select a line or connector, you can change its properties using the Properties Panel (just click the blue button next to the line end, see image below). You can change line color, the line width, and line pattern. You add or change the arrow types at the end of the lines. Plus, you can change the line type. For instance, you can make a straight line, a curved lined. If you select any number of lines or connectors at one time, you can set properties for all of them at once.

 

Use the  or  icon to add directionality to your line (for most lines). For specific shapes, like UML, ERD, BPMN, etc., you will get a selection of line end types specific to that shape type. The direction the arrows in this menu point translates as ‘left = line start point’ and ‘right = line end point’. So if you drew your line from right to left, and select the arrow that points to the right, you’ll see your line will get an arrow pointing to the left! If you consistently draw your lines/connectors from start to end, this will make adding arrows much easier.

Click on the  icon to select a color for your connector or line. 

Click on the  icon to change how thick your lines are in pixels. 

The  icon lets you choose from a selection of different patterns for the selected line, from finely dotted to solid.

Lastly, the  icon allows you to select a type of line or connector. The first choice is a straight line. The next three are connectors: right angle, rounded corner,and Bezier Curve. 

back to top

 

UML Cardinality

In Gliffy Online and Gliffy for Confluence v6.0 and above, you can add cardinality to your UML lines. If you drag a UML connector line onto the canvas, you will notice some cardinality boxes appear on each side. You can then use these to add cardinality to your UML diagram. 

back to top

 

Entity-Relationship arrows

In Gliffy Online and Gliffy for Confluence v6.0 and above, you can adjust your Entity-Relationship arrow ends to make the appropriate shape for your needs. 

If you don't see a pre-made ER arrow you would like to use, pull any of them onto the canvas then click into the blue, shape properties box. 

 

Click into the line properties and you will see a drop-down for both arrow ends. You can choose from here what type of shape you want to create. 

back to top

 

Bring to Front / Send to Back

As your document becomes more complex, you may find you need to control which elements are in the foreground and which are in the background. You can do this by selecting the desired element *be it a shape, a line, or a text box) and using the  icon to bring the selected element to the front or the  icon to send it to the back. In Gliffy Online, you can also send elements to the front or back by selecting them and right clicking to select these options in the context menu. 

back to top

 

Swimlanes

The Swimlane shapes can have up to 12 lanes added to them. You can add additional swimlanes by dragging a swimlane shape out to the editor, then click the blue custom properties box: 

Once you click into the shape properties, you can select the "Number of swimlanes" drop-down menu and select how many lanes you want it to have up to 12. 

back to top

 

Gliffy Basics

back to top

 

Adding Elements to the Drawing Canvas

back to top

 

Library Symbols


Select a shape from any symbol library, then drag and drop that shape onto the Drawing Canvas. To add text, start typing. To change the style settings, click the shape and open the blue properties menu.

 

 

 

 

back to top

 

Images


Before you can add an image to your Gliffy diagram, you need to upload it to Confluence:

  1. On the Confluence page where you are building your diagram, go to Tools > Attachments.
  2. Upload your image to Confluence.
  3. Return to the Confluence page and Insert or Edit your Gliffy diagram.
  4. Select the Images symbol library.
  5. Drag your images onto the Drawing Canvas like any other element.

Images can be moved, rotated, resized, or linked with connectors like any other element.

If you want to upload additional images while you are editing the diagram, click the Add Images button in the Images library. This will open the Confluence Attachments page in another browser tab. When you have uploaded your image, return to Gliffy and click the Refresh button. The new image will be available to use.

There is a 1MB limit for PNG, JPG, and GIF files. There is a 500MB limit for SVG files. 

back to top

 

Text Tool

Click the Text Tool button in the toolbar. Click anywhere on the Drawing Canvas and start typing. To define the width of your text box, select the Text Tool from the toolbar and draw the box anywhere on the Drawing Canvas with a click-drag-release, then start typing. Text box height expands automatically as you type. To change text style settings, click the text box and open the blue properties menu.

Text boxes behave like any other Gliffy element, and can be easily moved, resized, and rotated.

back to top

 

Ellipse and Rectangle Tools

Click the appropriate Ellipse or Rectangle button in the toolbar. Click anywhere on the Drawing Canvas and draw your shape with a click-drag-release. To change the style settings, click the shape and open the blue properties menu.

back to top

 

Connector Tool

The Connector Tool is most valuable when you already have other elements on the Drawing Canvas. Click the Connector button in the toolbar and connection points will appear on any symbols on the Drawing Canvas. Connect any two of these connection points with a click-drag, release. To change the style settings, click the connector and open the blue properties menu.

back to top

 

Straight Line Tool

Unlike the Connector tool, the Straight Line Tool will only draw a perfectly straight line, with no bends or corners. But you can still use it to link connection points on symbols, if a perfectly straight line is appropriate for your diagram. Click the Straight Line Tool button in the toolbar and draw a line with a click-drag, release. You can also connect any two connection points with a click-drag, release. To change the style settings, click the line and open the blue properties menu.

 

back to top

 

Moving and Manipulating Elements

back to top

 

Moving Shapes and Symbols

To move any element or group of elements, click it, then drag and drop it anywhere you like on the Drawing Canvas. While you’re moving the shape, you will see a bounding box and a display of the XY coordinates of the upper left corner of that object or group of objects. If you have snap-to-grid placement enabled, objects will automatically move in increments of 10 pixels. If you have drawing guides enabled, green lines will help you align the shape you are moving to the edges of other objects and red lines help you align the shape you are moving to the center of other objects.

You can also specify an exact location for any shape or group of shapes:

  1. Select the shape or group of shapes.
  2. Open the blue properties menu.
  3. In the X field, set the X coordinate for the upper left corner of the shape or group.
  4. In the Y field, set the Y coordinate for the upper left corner of the shape or group.

 

back to top

 

Moving Lines and Connectors

Instead of boundary boxes, lines and connectors have small circles defining each endpoint and, in the case of connectors with more than two segments, one to control each middle segment. If you click on the line or connector anywhere but on these circles, you’ll move the entire line without changing its shape. Clicking and dragging the circles will move only that end of the line or connector. If you move the shape that a line or connector is linked to, the line or connector will adjust to maintain the connection.

back to top

 

Resizing Elements

To resize any element or group of elements, select it so that the bounding box appears. Click any corner of the bounding box and drag it until the shape or group of shapes is the correct size. While you’re resizing the shape, you will see a display of the dimensions of the object. If you have snap-to-grid placement enabled, objects will automatically resize to increments of 10 pixels. If you have drawing guides enabled, green lines will help you resize the shape in alignment to the edges of other objects and red lines help you resize the shape in alignment to the center of other objects.

You can also specify exact dimensions for any shape or group of shapes:

  1. Select the shape or group of shapes.
  2. Open the blue properties menu.
  3. In the W field, define the width, in pixels.
  4. In the H field, define the height, in pixels.

Certain shapes, particularly complex Network or Floorplan symbols, have a locked aspect ratio, which will affect how they resize. You can easily lock or unlock the aspect ratio for any shape:

  1. Select the shape.
  2. Open the blue properties menu.
  3. Check or uncheck the Lock Aspect Ratio box.

 

back to top

 

Rotating Elements

To rotate any element or group of elements, select the shape or group of shapes. A bounding box will appear with a rotation icon at the top. Click the rotation icon, drag it into the correct orientation, then release. While you are rotating the element, you will see a display of the rotation in degrees. If you have snap-to-grid placement enabled, objects will automatically rotate in increments of 5 degrees.

You can also specify exact rotation for any shape or group of shapes:

  1. Select the shape or group of shapes.
  2. Open the blue properties menu.
  3. In the Rotation field, define the exact rotation in degrees clockwise.

 

back to top

 

Lock/Unlock

If you have carefully positioned an element and want to be sure that you don’t accidently move it while you edit the rest of your diagram, you want to lock that element:

  1. Select the shape.
  2. Open the blue properties menu.
  3. Check (or uncheck) the Lock Shape box.

Note that if you select a locked and unlocked shape in the same group, you will be able to move both shapes together as if they were an unlocked group. When the group is released, the locked object will be locked to its new position.

back to top

 

Group/Ungroup

If you have carefully positioned several elements in relation to each other, and you want to be able to move and manipulate them as if they were a single object, you can add them to a Group:

  1. Select the shapes.
  2. Click the Group button in the toolbar.

To break up the group and treat each element as an individual object again, select the group and click the Ungroup button.

back to top

 

Bring to Front/Bring to Back

If you have positioned an element correctly, but it overlaps with other objects in a way you don’t like, you can move any object into the foreground or background:

  1. Select the shape or shapes.
  2. Click the Move to Front or Move to Back button in the toolbar.

This feature is especially helpful if you are using shapes or images as a background for your diagram.

back to top

 

Evenly Distributed Shapes

You can align and evenly distribute a group of shapes on your diagram. To do so, select the shapes you’re working with, click the blue properties menu that appears next to your shapes, and then use the various Align and Distribute buttons to make them distributed the way you want. 

 Align Options

  1. Align left
  2. Align center
  3. Align right
  4. Align top
  5. Align middle
  6. Align bottom

Aligning takes all the selected shapes and aligns them with the shape that is furthest to the left, center, right, etc. depending on what you select. 

 

Distribute Options

  1. Distribute vertical center
  2. Distribute horizontal center

Distributing takes all the selected shapes and distrubtes them evenly either vertically or horizontally depending on what you select. 

 

 

back to top

 

Themes

In Gliffy Confluence Plugin version 5.3 and above, you can choose to apply color themes to your diagram for quick and easy styling. Clicking the Diagram Themes button from the Toolbar will open up the Themes box on the right side of your diagram. 

 

This moveable box can be moved anywhere on your canvas. 

 

Hovering over each theme creates a preview of it applied to the diagram on your drawing canvas. Clicking on the theme applies it to your diagram. To undo an applied theme, select Edit->Undo, or Ctrl+Z.

Completed diagram with no theme: 

Diagram Theme applied: 

 

back to top

 

Changing Element Styles

back to top

 

Shapes and Symbols

To change the style of any shape or symbol, select it then click the blue button to open the properties menu. You can make the following adjustments (some options are not available on all elements):

  • Change the Shape Color. (On some of the more complex shapes, such a Network symbols, only part of the object had a customizable color.)
  • Change the Border Color.
  • Change the Border Thickness.
  • Toggle the Gradient on and off.
  • Toggle the Drop Shadow on and off.
  • Set the X/Y coordinates of the upper left corner of the element.
  • Set the Width and Height of the element.
  • Specify a Rotation for the element.
  • Lock or unlock the element Aspect Ratio.
  • Lock or Unlock the element position.

 

back to top

 

Lines and Connectors

To change to style of any line or connector, select it then click the blue button to open the line properties menu. You can make the following adjustments:

  • Set the Beginning Arrow style.
  • Set the End Arrow style.
  • Change the Line Color.
  • Change the Line Thickness.
  • Change the Line Style to dotted, dashed, or solid.
  • Change the Line Type to straight line, sharp corners, rounded corners, or smooth curves.

 

back to top

 

Text

You can add text to almost any element: shapes, symbols, lines, and connectors. To add text, just select the element and start typing. Once an element has text associated with it, you will be able to modify the text style.

To change to text style for an entire element, select that element (or group of elements) then click the blue button to open the text properties menu. If you only want to change a single letter, word, or phrase within an element, double-click the element to enter Text Edit mode, then highlight the words you want to modify. You can make the following adjustments:

  • Set the text to Bold, Italic, or Underline.
  • Change the text Alignment to left, center, or right.
  • Change the Font Family.
  • Change the Font Size.
  • Insert or remove a Hyperlink.
  • Change the Font Color.

 

back to top

 

Viewing and Managing the Diagram Canvas

back to top

 

Document Properties

Selecting File->Document Properties will open up the Document Properties panel for the diagram you are in. By default, the Width and Height of the staging area are set to 5000 x 5000 pixels and is the maximum size for a diagram. You can set the limits for your diagram size here. 

back to top

 

Snap-to-Grid Placement

By default, snap-to-grid placement is enabled on your diagrams so that you move or place objects in increments of 10 pixels.

You can easily toggle snap-to-grid off and on again:

  1. Go to File > Document Properties.
  2. Check or uncheck Snap to Grid.

 

back to top

 

Drawing Guides

If you have drawing guides enabled, green lines will help you move or resize shapes in alignment to the edges of other objects and red lines help you move or resize shapes in alignment to the center of other objects.

You can easily toggle drawing guides on and off again with the Drawing Guides button in the toolbar.

back to top

 

Zoom

If you want to get a closer (or wider) look at your diagram, you can use the Zoom dropdown in the toolbar to set the zoom.

The + Zoom and - Zoom buttons give you a tool that allows you to zoom in (or out) on a specific area of the diagram by clicking the Drawing Canvas.

You can also zoom in a very specific are by selecting the + Zoom tool and drawing a rectangle around that area with a click-drag-release.

back to top

 

Pan

If you want to move around a large diagram without using the browser’s scroll bars, the Pan tool lets you pan through the visible area of your Drawing Canvas: just click, drag, and release.

If you want a quick shortcut, holding down the space bar on your keyboard automatically switches your cursor to the pan tool.

back to top

 

Saving and Returning to Confluence

The Save button in the upper right corner will let you save the diagram. If this is the first time you’re saving the diagram, you will be prompted to enter a name.

The Exit link in the upper right corner will return you to your Confluence page. If you have not already saved the diagram, you will receive a warning asking to confirm the navigation. If you leave without saving, your most recent edits may be lost.

The Breadcrumb Trail in the upper left will also take you can to Confluence. If you have not already saved the diagram, you will receive a warning asking to confirm the navigation. If you leave without saving, your most recent edits may be lost.

back to top

 

Exports


Gliffy also allows you to export your diagram in several formats. To export your diagram, go to File and select the desired format:

  • SVG
  • Gliffy .gliffy (standard Gliffy diagram format)
  • Gliffy .gxml (older Gliffy diagram format)
  • JPG
  • PNG

 

back to top

 

Revision History

Every time you save a diagram, Gliffy keeps a record of that version. At any time, you can revert to an earlier saved version of your diagram:

  1. Go to File > Revision History.
  2. Select the version you would like to recover and click Okay.
  3. If you have not saved the currently active version of the diagram, you will be asked to confirm. You can choose to Continue Working on the current unsaved diagram, or you can Open Revision to discard the active diagram and restore the earlier version.

 

back to top

 

HTML5 Viewer

Gliffy diagrams are displayed on Confluence pages using our HTML5 viewer as live web content, not just static images. This makes it much easier to interact with your diagrams without switching into edit mode.

 

Placing your mouse cursor over the diagram within Confluence will make the Chrome appear. 

back to top

 

Preview and Zoom

Roll your mouse over an in-page diagram and you’ll see a button that says Zoom

This gives you a preview pane where you can take a closer look. And because this preview is rendered in HTML5, the text and drawings will never lose resolution, no matter how tight the zoom.

back to top

 

Links and Text

Because Gliffy diagrams are rendered in HTML5, any text in the diagram behaves just like page text. You can copy text from a diagram to paste into other applications. You can search a page for any term in the diagram. And of course all the links in your diagrams are live and clickable.

back to top

 

Keyboard Shortcuts

As you get more proficient using Gliffy, you’ll find that the built in keyboard shortcuts speed up your work. You can see a full list of keyboard shortcuts at any time by going to HelpShape Shortcuts or Help >Document Shortcuts in the top right of the Document Editor.

back to top

 

Context Menu

For quick access to common actions, a right click will open the Context Menu.

If no element is selected, the Context Menu lets you Paste a copied element, Select All, adjust Zoom, and View Diagram Source.

If an element is selected, the Context Menu lets you Cut, Copy, Delete, Lock/Unlock, and Send to Front/Send to Back.

If a group of elements are selected, the Context Menu gives you the element options plus Group/Ungroup.

back to top

 

Gliffy Diagrams on the Attachments Page

Confluence stores your Gliffy diagrams as attachments on the page where they were created. For every Gliffy diagram, there will be two files: the Gliffy diagram file (labeled GLIFFY DIAGRAM), and a thumbnail of your diagram saved as a PNG (labeled GLIFFY IMAGE). You can find both files by navigating to the parent page and going to Tools > Attachments.


From the attachments page, you can manage these files:

  • View lets you preview how the diagram will appear in a Confluence page.
  • Edit launches the diagram in the Gliffy editor.
  • Properties lets you rename a file and review other details.
  • Remove deletes the file permanently.

Note that if you rename or remove a Gliffy Diagram that is displayed on the page, the page will show a broken macro. Edit the page and delete the Gliffy macro or update it to point to the correct diagram name.

If you rename or delete a Gliffy Image, a new PNG will be automatically generated the next time you edit and save the diagram.

back to top

 

Version control

You can also find previous versions of your diagrams on the attachments page. Just click the arrow at the front of the listing to expand a list of all previously saved versions of the file.

Gliffy Images: Click on the version number to view the PNG file.

Gliffy Diagrams: Click on the version number to download the diagram as a Gliffy GON file (or a Gliffy GXML file, if you are using an older version of the Gliffy Confluence Plugin).

Note: To revert to a previous version of a diagram, open it in the Gliffy editor and go to File > Revision History.

back to top

 

Hyperlink Navigator

In Gliffy, you can add a link to any text on any shape in your diagram. Because of the HTML5 viewer, these links will be active when the diagram is embedded in your page:

  1. Select the text you want to link.
  2. Open the blue text properties menu.
  3. Click the Link icon.
  4. Use the Link Navigator to add a link.

The Link Naviagtor lets you search for any page on any wiki in your Confluence instance, browse the Confluence pages that you have recently viewed, link to attachments on the current Confluence page, link to page content (sections formatted as h1, h2, etc.) on the current page, or set up a Web link to any URL.

back to top

 

Search for Confluence Pages

Select Search from the link navigator menu to link to another page in your Confluence instance.

back to top

 

Link to Recently Viewed Confluence Pages

Select Recently Viewed from the link navigator menu to browse the pages in Confluence you have most recently visited.

back to top

 

Link to Attachments

Select Attachments from the link navigator menu to link to any of the other attachments on this Confluence page.

back to top

 

Link to Page Content (Anchors)

Select Page Content from the link navigator menu to link to any content of the current page that has been formatted as a heading (h1, h2, etc.)

back to top

 

Link to Web Pages

Select Web Link from the link navigator menu to link to another page anywhere on the Web.