How to integrate clickable SVG in Confluence

[Marc Veser]

Hi, 

I want to use a SVG file as navigation map with multiple links to other confluence pages. I've integrate the SVG file by typing '!' and then selected the attachment (thanks to the tipps here in the community). Unfortunately the links in the SVG file don't work any more. When clicking on the SVG the preview is opened and here again the links don't work. 

I also had the idea to link to the attachment address directly to prevent the preview mode. Unfortunately this automatically downloads the SVG file and a local copy is then displayed. 

How can I display the SVG with working links without downloading it and without using additional plugins which I'm not allowed to install/use?

Any help is highly welcome,

Marc

[Mikhail “in Peru”]

Since this thread still comes up in search, here is where things stand in 2026.

Confluence Cloud renders an attached SVG as a flat image on purpose: an SVG file

can carry scripts, so the platform strips the interactive part rather than run it.

That is why links inside your navigation map stop working, and it is not something

an admin setting can switch back on.

One thing worth flagging for anyone arriving from Google: the HTML macro and user

macro suggested earlier in this thread exist in Confluence Data Center and Server,

not in Cloud. Cloud has no native HTML macro at all, so on Cloud that route is

closed regardless of your permissions.

What does work without buying anything: draw the diagram in a diagramming app that

renders natively inside Confluence, such as draw.io, which keeps links on shapes and

is free for small teams. That only helps if the diagram does not exist yet — it is no

answer when you already have an SVG exported from Figma, Illustrator or Visio.

One more thing worth knowing: SVG out, recommended earlier in this thread, is no

longer maintained, so anyone landing here from Google should not count on it.

Disclosure: I build a Forge app that solves exactly this — the diagram keeps its

links, and clicking a shape opens the Confluence page behind it. It runs inside

Atlassian's own infrastructure, so nothing leaves your site, which usually settles

the security objection that started this thread. Documentation is at

https://horizonventures.app/docs/ and there is a demo you can click through

without installing anything at https://horizonventures.app/clickable-svg.html

[mantibi]

I have exactly the same issue as Marc. I need the image SVG links to work, either in the page read mode, or by previewing the image.

Any news about this issue, and possible ways to solve?

[Andreas Purde]

Dear @mantibi ,

in case you are allowed to install apps you can use SVG Out.

Kind regards

Andreas

[mantibi]

Hello Andreas, thanks for your answer.

I am not Confluence admin, but I will try to ask the one of my company.

[Andreas Purde]

Dear Marc,

there are two options under the conditions you mentioned which I'm aware of:

• Use the HTML macro and embed the SVG there. The HTML macro comes with Confluence but is deactivated per default. You need your admin to activate it.
• Write your own user macro in Confluence. A couple of lines are sufficient. However you also need an admin to "install" a user macro in your instance.

Andreas

[Marc Veser]

Hi Andreas,

thank you for your answer. Unfortunately both options seem to not work for me because we are not allowed to install user macros or activate the HTML macro. Is there another option?

Regards,

Marc

[Andreas Purde]

Dear Marc,

are you allowed to specify Custom HTML in your Confluence configuration?

The option I'm thinking of: if you add a script as Custom HTML which loops through the images on a page, checks whether they are a SVG and changes the img-tag to embed-tag... could be worth a try.

Andreas

[Marc Veser]

Hi Andreas,

I've only space admin permissions. I couldn't find a place where to check if I'm allowed to specify Custom HTML. Do you know how I could check this? 

Marc

[Andreas Purde]

This is on Confluence level not Space level. Sorry.