Include an SVG image on a Confluence page.
Asked by brad:

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?


Answers:
author: Matthias Viranyi
body: PUMP!

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 ..

comments: author: iwan-aucamp
body: Don't besmirch Microsoft's "fine" name by comparing them to Atlassian. Atlassian sets the standard for utter garbage software.


author: Ad
body: 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)

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


author: Stephan Hradek
body: What does "On the confluence page type '!'" mean? When I edit the page and type '!' I get an '!'.


author: Sylvain Bernard
body: does not work for me in Confluence Cloud :\<


author: Jose Luis Casarrubias
body: Wooow! works fine for Confluence Server


author: mawi
body: **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.

![confluence-new-editor-svgimages-incorrect.png](https://community.atlassian.com/t5/image/serverpage/image-id/134779iCDE6794B49394231/image-size/large?v=v2&px=999 "confluence-new-editor-svgimages-incorrect.png")

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


author: ALEX FERNANDES JUNCA
body: Works for me! Thanks


author: dellagustin
body: Support for SVG is reported on the confluence issue tracker: <https://jira.atlassian.com/browse/CONFSERVER-1762>

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


author: Bob Swift (personal)
body: This is a reference: [How to display **SVG** attachments in Confluence](https://bobswift.atlassian.net/wiki/display/info/How+to+display+SVG+attachments+in+Confluence?src=search)

comments: author: brad
body: Is it possible to do this for an OnDemand instance too?


author: Dobroslawa Wierzbicka
body: This level of customization wouldn't be possible in an OnDemand instance, as per the [Restricted Functions](https://confluence.atlassian.com/display/AOD/Restricted+Functions+in+Atlassian+OnDemand). The solution is only available for Confluence Server installations.


author: Tomas Girardi
body: SVG should be supported in cloud instances... It's 2016!


author: Dan Rivett
body: 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.


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


author: Der Watz
body: this issue is still there.

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

I can' t believe ...

comments: author: Matthias Viranyi
body: Yeah, this is ridiculous ...


author: Charles Reitzel
body: April, 2018 and counting ... !?!?


author: Eliot Cole
body: may now ... ;)


author: Yuval Kalugny
body: July... :\|


author: Sebastian Poxhofer
body: December -.-


author: Stephan Hradek
body: July 2020


author: Justin Cook
body: August 2020


author: Peter Vojtech
body: February 2021


author: iwan-aucamp
body: 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.


author: Stefan Theisen
body: June 2021 alike


author: AndreasS
body: 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

   ```
   /opt/confluence/webapps/ROOT/WEB-INF/classes/mime.types
   ```

2. Restart Confluence
3. attach the image using

   ```
   !&lt;Bildname&gt;
   ```

   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](https://marketplace.atlassian.com/plugins/com.atlassian.confluence.plugins.editor.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 [](/questions/222794/serve-svg-inline-in-confluence)<https://answers.atlassian.com/questions/222794/serve-svg-inline-in-confluence>)


author: Andreas Purde
body: 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**

<https://marketplace.atlassian.com/plugins/de.edrup.confluence.plugins.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?$body
```

2) include that macro on a page

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


author: Peter Van de Voorde
body: Hi Bradley,

Could this page help you out? <https://bobswift.atlassian.net/wiki/display/CVP/How+to+install+SVG+conversion+support>

Best regards,

Peter

comments: author: Bob Swift (personal)
body: You don't want conversion for this use.