How to Use SVGs in Confluence
Confluence treats uploaded SVGs as attachments, not images — these are the routes to actually rendering them.
Drop your image here
Supports PNG, JPG, BMP, WEBP up to 5MB
Why SVG Uploads Show as Links
For security, Confluence Cloud doesn't render uploaded SVG attachments inline — they appear as download links instead of images. The workarounds: convert to high-res PNG for simple display, use an HTML/iframe macro (if admins enabled one) referencing a hosted SVG, or use marketplace apps that sandbox-render SVG attachments.
- SVG attachments become download links, not inline images
- This is a deliberate XSS-protection measure
- HTML macros or marketplace apps re-enable inline rendering
The draw.io Answer for Diagrams
Most Confluence diagram needs are better served by the draw.io (diagrams.net) integration: it imports existing SVGs, stores diagrams natively in the page, renders them as sharp vectors, and keeps them editable by the whole team — no attachment-rendering issues at all.
- draw.io imports SVG files into editable diagrams
- Diagrams render sharp and stay team-editable
- Native integration means no rendering security blocks
Frequently Asked Questions
Why does Confluence block SVG rendering?
SVGs can contain scripts, so rendering user-uploaded SVGs inline is an XSS risk. Confluence Cloud opts for safety, showing links instead. Data Center admins have some configurability.
What's the fastest way to show an architecture diagram?
Import the SVG into a draw.io block on the page. You get sharp rendering plus future editability — better than any attachment workaround.
Related guides
Ready to Convert Your Image to SVG?
Free online converter — no sign-up, no watermarks, results in under 3 seconds.
Try It Free — Convert Image to SVG