Import a Visio file into Confluence

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

To import a Visio file into Confluence, insert a Capable diagram, choose Visio import in the library picker and pick your .vsdx file. Capable converts it and opens it in the draw.io editor, so shapes, connectors and text stay editable rather than becoming a flat picture. Check the result, then save it to the page.

#Before you start

  • The file is a .vsdx (or a .vssx stencil). Older Visio formats such as .vsd must be re-saved as .vsdx in Visio first.

  • draw.io is turned on for your site. Visio import is switched off whenever draw.io is, because the import lands in the draw.io editor.

  • You can edit the page.

#Steps

  1. Edit the page, type /diagram and choose Diagram (Capable).

  2. In the library picker, choose Visio import. It is under Whiteboard and visual.

  3. Pick your .vsdx file.

  4. Wait for the conversion. The diagram opens in the draw.io editor.

  5. Check the result and fix anything that did not come across.

  6. Give the diagram a title, select Save, then publish the page.

#What happens next

The diagram is an ordinary draw.io diagram from now on. Edit it like any other, and it versions, exports and takes comments the same way.

#If it does not work

  • Visio import is missing from the picker: draw.io has been turned off by your administrator.

  • Custom or licensed stencils can arrive as plain shapes. Check before you delete the original file.

  • A very large file takes a while to convert. It is not stuck.

It arrives as a diagram, not a picture of one.