Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Best way to upload Document on Confluence


I have 1000+ pages of document (word doc) which consists of screenshots, process and configuration content and also the embedded file in the document. I think there are four different ways i.e. are Export file, Word Macro, Ctrl +C option and File attached option. But I am facing the issue on all above the options like some of the screenshots are missing, in-consistency on Confluence space while loading the page on Space. 

Sometimes it really make me to think to shift from Confluence to Notion for Documentation.

3 answers

2 votes
Matt Reiner _K15t_ Marketplace Partner Sep 12, 2022

Hey @Krupal Jawanjal


This is certainly a very weak point for Confluence. Michelle's article details a lot of the limitations with the Word importer. One thing that's problematic is the way some images are stored within the docx format directly. It essentially keeps the importer from pulling these images in during import. This makes the process exceptionally difficult for folks like you with such a massive document.

I'm not sure if Notion handles situations like this better, since it's an issue with the docx format.

But, unfortunately, there's no one solution I can offer outside of Michelle's suggestions in this article. I can say that once you've gone through the pain of getting all the content into Confluence, it really is a great place to manage documentation. I've worked for two companies now who've had all our help content in Confluence. I did the full migration for the last one, manually, and it wasn't fun. But I'm glad I did.

2 votes
G subramanyam Community Leader Sep 12, 2022

Hi @Krupal Jawanjal welcome to the Atlassian community.

I understand that your are trying to upload or uploaded the word document to Confluence and then you are facing issues with it's content placement or display on the spaces. If yes, then please be informed their are multiple factors that contribute to the content display.

Few such factors: Root page title, Title conflicts, Split by heading, documents containing wiki markup etc..

I would request you to thoroughly check the "Import a Word Document into Confluence" and "Import content into Confluence Cloud" documents for details and steps.

@Rafael Meira @Daniel Capizzi @Monique vdB ,can you please help me in this issue.

Hi @Krupal Jawanjal

I would direct you to the answers provided by @G subramanyam and @Matt Reiner _K15t_ above, and in particular Michelle's article linked by Matt. All will be great resources to understand the capabilities, limitations and workarounds that exist for Confluence document import.

Don't forget to also accept answers that have helped - it's a great way to say thanks to our community contributors, and will also help other people with similar questions to yours find the information they need in the future! 😊



Suggest an answer

Log in or Sign up to answer

Atlassian Community Events