Using in Confluence Cloud

Gliffy mass import

Administrators can convert all of the Gliffy diagrams in a Confluence Cloud instance into diagrams via the Confluence Settings.

  1. Go to the Confluence Settings in your Cloud instance.
  2. Select on Gliffy Import in the left menu.
  3. Click on the Start Import button and wait for the import to complete.

Start the Gliffy mass import to diagrams in Confluence Cloud

Learn how to use the Gliffy to mass import feature

Embed, copy and move diagrams

There are a number of ways to reuse your diagrams in Confluence Cloud:

Embed (reuse) a diagram

Embedding a diagram works similarly to the “Excerpt” and “Excerpt Include” Confluence macros - there is one master diagram (single source) that is simply displayed (embedded) in other locations using the diagram viewer.

Use the the Embed diagram macro and choose an existing diagram.

Add the _Embed diagram_ macro to a Confluence Cloud page

You can also embed diagrams from cloud storage platforms in Confluence Cloud.

Copy a diagram

You can duplicate a diagram file and then edit the copy without changing the original diagram. When you add the diagram macro to the page, select Recent or search for an existing diagram file, select it, then click Create.

Select a diagram from the Recent tab, add a new diagram name and click Create to copy a diagram in Confluence Cloud

Move a diagram

To move a diagram from one page to another, you first need to copy the diagram (create a new diagram file in your instance), and then delete the diagram macro from the original page. Don’t delete the diagram file itself to preserve your page’s revision history.

Learn more about reusing diagrams in Confluence Cloud

See how to recover a diagram that was previously moved

Resize the diagram viewer in a page

By changing the zoom within the diagram editor, you can make your diagram appear larger or smaller on your Confluence Cloud page.

Edit your diagram and make sure you have nothing selected, then click Zoom in the format panel and change the zoom percentage. You changes will appear when you save your diagram and publish your changes.

Customising in Confluence Cloud

Confluence Cloud administrators can customise to make it easier and faster for their users to create diagrams following a consistent style. This is especially useful when they need to use corporate assets, follow corporate style guidelines, or use custom shape libraries and templates.

Style to match your corporate image

By editing the JSON configuration code, you can set new default shape and connector styles, colour palettes, and fonts, as well as the colour of the UI.

For detailed steps and examples, see the linked documentation for each feature you want to customise.

Customise the style palette: The style palette is displayed at the top of the format panel on the Style tab.

Customise the colour palettes: The colour palettes are displayed whenever you click on a colour button in the format panel. Customise one or more of the palettes to display your corporate colours.

Customise the font list: The font list appears on the Text tab in the format panel. Set which fonts appear in the font list by default, add fonts that are hosted on the web (e.g. Google), or add your own custom font file if you need to.

Make the editor UI match your Confluence colours: If your users are disoriented by opening the editor when it is a different colour to your Confluence Cloud theme, you can set a new UI colour for the menu bar.

Load plugins by default: If your employees regularly use one of the plugins, for example the anonymize plugin, you can add these plugins to the JSON configuration and load them by default.
Note: that these plugins are provided as-is, as unsupported examples for developers.

  1. Open your Confluence Cloud settings.
  2. Go to the Configuration in the Atlassian Marketplace section on the left.
  3. Edit the JSON configuration code in the Configuration tab.

Administrators can specify custom colours for in Confluence Cloud

Provide shapes and corporate assets in custom libraries

Make a custom shape library available by default: When your users need to add complex or specific shapes to their diagrams, or add images and other corporate assets (like a copyright notice or a logo), you can add a custom shape library to and make it available by default.

  1. Add the custom shape libraries via the Custom Libraries tab in the Configuration section in your Confluence Cloud Settings.
  2. Set it to open by default for all users by editing the JSON code on the Configuration tab.

Custom libraries appear under the scratchpad in Confluence Cloud

Add custom templates to diagram faster

Custom templates are useful when multiple users need to create a similar set of diagrams, or work from the same foundation. They help users diagram both faster and more consistently in your corporate or departmental styles.

Add and categorise custom templates: You can custom template categories and diagrams that users will see first when they create a new diagram.

For example, add your own floorplan template for regularly changing seating arrangements, UML diagram templates for your core application code or databases, network diagram templates, infographic backgrounds, and more.

  1. Add the custom templates via the Custom Templates tab in the Configuration section in your Confluence Cloud Settings.
  2. Add template diagrams to your template category pages.

Create a new diagram from a custom template in for Confluence Cloud


Administration and licensing