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

Upload attachments to confluence via rest api

I am able to create / upload an attachment file to our confluence via rest api call scripts below:


curl -L -D- -u username:password -X POST -H "X-Atlassian-Token: no-check;" "file=@<path to file>" https://<hostname>/rest/api/content/{page_id}/child/attachment


This script works and I found the attachment icon in the confluence page. However the icon is sooo small next to the header and it is hard to find. Since the page I created is for display report to senior engineers and managers who are usually very busy.

Is there are way to make the attachment in the body of the page so that it is easy to find or is there a way to post image / snapshots directly in the body of the page?



3 answers

1 accepted

0 votes
Answer accepted
DPK J Community Leader Nov 18, 2019

@Zhenye NaWelcome to the community!

First of all very nice question. Now, let jump to the possible solutions that can presumably help you resolve your issue,

Solution 1 - Using HTML Macro and Base64 Encode Image

  • Push image directly into confluence page, using structured format of HTML Macro
< ac:structured-macro ac:name = "html" >
   < ac:plain-text-body > <![CDATA[<div><img height="" width="" src="data&colon;image/png;base64,...." />"</div>]]> </ ac:plain-text-body >
</ ac:structured-macro >

Solution 2 - Displaying attachment from source

Followed the solution from


got json response via a PUT request


here is the body section of response


"body": {
"storage": {
"value": "<p>Display attachment in body of the page</p>",
"representation": "storage",
"_expandable": {
"content": "/rest/api/content/98797437"
"_expandable": {
"editor": "",
"view": "",
"export_view": "",
"styled_view": "",
"anonymous_export_view": ""


But the pdf attachment does not display in the page yet, am I missing something ?


I ran

PUT /rest/api/content/<PAGEID>?

With a Payload of:

"title":"TITLE OF PAGE",
"value":"BODY OF PAGE",

@Zhenye NaI don't think PDF's are displayed inline by default. You can only add link to them.

For PDF Preview, you can try some external plugin from Marketplace, I myself don't use any currently so can't suggest, sorry for that.

Like Zhenye Na likes this

Thanks! at least I know this cannot be done currently. 

Is it possible to display images in the body using rest api? if so, any instructions?




Hi DPK. I would really appreciate if you share a working example of Solution 1, that you mentioned above, we are encountering an issue with it, we get error:

Uncaught SyntaxError: Unexpected identifier at Line 10


Our code is:

var jsondata = {
"id": "20054524",
"version": {
"number": 19
"title": "EnterNewValue",
"type": "page",
"body": {
"storage": {
"value":"<p>Adding image to page</p><ac:structured-macro ac:name = "html">
<![CDATA[<div><img height="720px" width="1512px" src="data&colon;image/png;base64,iVB...." /></div>]]>
"representation": "storage"

DPK J Community Leader Jan 18, 2021

@Alok Juneja I think only mistake you are making it not escaping html sent in value. 


can you guide me, i am struck to upload a image in confluence with rest api. i don't know how to solve this problem.

Suggest an answer

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

🎨 Add some visual life to your templates

Hi Atlassian Community, My name is Avni Barman, and I am a Product Manager on the Confluence Cloud team. Based on feedback from you, we are giving admins more power to create templates that a...

296 views 6 9
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