Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Include an SVG image on a Confluence page.

I want to include an SVG image on a Confluence page but I'm not sure how to do it. Is it possible without having to convert it to raster? How do I do it?

8 answers


Can we please have thumbnails and directly embedded SVG graphics without the need to contact an admin to "restart" Confluence etc?!

I don't think this feature is "new" and "SVG" is as well not. So please Atlassian, move!

Otherwise Atlassian will become the Microsoft of SaaS counterpart ..

Don't besmirch Microsoft's "fine" name by comparing them to AtlassianAtlassian sets the standard for utter garbage software.

Support for SVG is reported on the confluence issue tracker:

Vote it up if you are also waiting for this issue.

1) Attach .svg file to Confluence page
2) On the confluence page type '!' then select the attached SVG

3) It renders inline
4) Adjust the image size as needed (by default it is set to 0px)

Works well without any special permission or server restart. You can even delete the svg attachment after its rendered.

Like # people like this

What does "On the confluence page type '!'" mean? When I edit the page and type '!' I get an '!'.

Like Martin Gregory likes this

does not work for me in Confluence Cloud :<

Wooow! works fine for Confluence Server

Cloud: This (attach svg, insert image tag) used to work fine. The new editor breaks this.

As we are forced to start to use the new editor, we are discovering this now. Pages that have not changed for a few years, now get the improved editor with graphics that become unreadable after conversion.


(Gah. I am sooooooo frustrated with it, software quality and business in the 2020's is sucking worse than ever </grumpyoldfart-rant> )

Like # people like this

Works for me! Thanks

Is it possible to do this for an OnDemand instance too?

Like Andrey Kupreychik likes this

This level of customization wouldn't be possible in an OnDemand instance, as per the Restricted Functions. The solution is only available for Confluence Server installations.

SVG should be supported in cloud instances... It's 2016!

I also request this. Architectural diagrams created externally should be embeddable in Confluence pages - on the Cloud hosted Atlassian - using the SVG format. That would be really useful.

Like Jim Parris likes this

Woah ... that is pretty lame ... maybe we could also limit images to BMP files of at most 12x12px?

Like # people like this

As stated in the links above, you can patch Confluence to show an SVG by

  1. Add the line
    image/svg+xml svg svgz
    to the file
  2. Restart Confluence
  3. attach the image using

    in Confluence Editor

Unfortunately, to use the two smallest image size reduction buttons or setting a smaller size then 300px does not work with Confluence richtext editor because Confluence tries to create a thumnail on server side which is currently not supported for SVGs (and the Confluence server will return a empty, broken image).

The workaround is to use the free Confluence Source Editor, use button "<>" and set the size of teh SVG to whatever you want (which should be perfectly ok for vector graphics).

(see also

this issue is still there.

Why is it not possible, to fix this problem after years?

I can' t believe ...

Yeah, this is ridiculous ...

April, 2018 and counting ... !?!?

may now ... ;)

Why would Atlassian fix it if they can milk Confluence for all it is worth without fixing it?

Atlassian does not care about quality, they don't care about user experience, they know the people paying are not the people using it, so they don't care about the people using it.

June 2021 alike

You don't want conversion for this use.

Just for completeness: You will be able to see SVG images performing the steps mentioned in the other comments on the page. However all links you may have in the SVG are not usable according to my experience. There are two ways to get this fixed:

1) Use the plugin svg-out

2) Using Confluence native functions and a user macro

In case you want to use links and don't want to use the plugin mentioned here you can still to the following:

1) making a more or less empty user macro (unrendered)

## @noparams

2) include that macro on a page

3) paste the the SVG in clear text from <svg> including </svg> into the macro body.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

591 views 19 17
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you