Skip to main content

Modern Importer & Exporter for Confluence - User Guide

Table of Contents​

Introduction​

Modern Importer & Exporter for Confluence makes it easy to export and import your Confluence content. Export pages with their images included, import Word documents, spreadsheets, or entire folder structures, and choose from multiple formats — all with a native Confluence look and feel.

Key Benefits​

  • Images and attachments included — exports bundle images alongside your content
  • Multi-format export — choose Word, Markdown, HTML, JSON, or XML (or all at once)
  • Word and spreadsheet import — import DOCX, XLSX, CSV, Markdown, HTML, and JSON files
  • Folder import — drag a ZIP to import whole folder structures with hierarchy preserved
  • Native Confluence experience — redesigned with Atlaskit components, dark mode support
  • Step-by-step wizard — guided 3-step flow for both import and export
  • Real-time feedback — track progress and see per-file results

Features Overview​

Export​

  • Browse and select pages from any space
  • Export to one format or bundle multiple formats in a single ZIP
  • Images are downloaded and included in the export
  • Organized by space with a manifest file listing everything exported

Import​

  • Drag and drop files or a ZIP archive
  • Folder structures are preserved with a tree preview
  • 3-step wizard: upload files, choose target space, review and confirm
  • Per-file success/error results

Two Ways to Access​

  • Global Page: Apps > Modern Importer & Exporter — full wizard experience
  • Content Action: Right-click any page or blog post — quick single-item export/import

Getting Started​

Installation​

  1. Install from the Atlassian Marketplace
  2. The app appears in two places:
    • Global Page: Apps > Modern Importer & Exporter for Confluence
    • Content Action: Right-click menu on any page or blog post

First Use​

  1. Navigate to Apps > Modern Importer & Exporter for Confluence
  2. You'll see tabs for Export and Import
  3. Try a small test export to get familiar with the flow

Export Content​

From the Global Page​

Step 1: Select a Space​

  1. Choose a space from the dropdown
  2. Browse the content table showing pages and blog posts
  3. Check the items you want to export

Step 2: Choose Formats​

  1. Select one or more export formats:
    • Word (DOCX) — for editing in Word, Pages, or Google Docs
    • Markdown — for technical docs and GitHub wikis
    • HTML — for web publishing
    • JSON — for data processing or Confluence re-import
  2. Multiple formats are bundled together in one ZIP

Step 3: Export​

  1. Click Export
  2. Progress is shown inline
  3. The ZIP downloads automatically when done
  4. Open the ZIP to find content organized by space, with images in an attachments/ folder

What's in the Export ZIP​

confluence-export-SpaceName-formats-date.zip
├── MARKDOWN/
│   └── SpaceName/
│       ├── Page-Title.md
│       └── attachments/
│           └── image.png
├── DOCX/
│   └── SpaceName/
│       └── Page-Title.docx
├── ADF-JSON/
│   └── SpaceName/
│       └── Page-Title.json
└── export-manifest.json

From the Content Action (Quick Export)​

  1. Right-click any page or blog post
  2. Select Modern Importer & Exporter
  3. Choose your format and click Export
  4. Download starts automatically

Import Content​

From the Global Page​

Step 1: Upload Files​

  1. Switch to the Import tab
  2. Drag files or a ZIP onto the drop zone, or click to browse
  3. For ZIP files, you'll see a folder tree preview
  4. Supported formats: JSON, Markdown, HTML

Step 2: Choose Target Space​

  1. Select the Confluence space to import into
  2. Review the list of files to be imported

Step 3: Review and Confirm​

  1. See a summary of what will be imported
  2. Click Import
  3. Watch per-file results (success or error for each item)

From the Content Action (Quick Import)​

  1. Right-click the target page or blog post
  2. Select Modern Importer & Exporter
  3. Switch to the Import tab
  4. Upload a file and choose import mode:
    • Override — replace existing content
    • Append — add imported content at the end
  5. Click Import

Supported Formats​

Export Formats​

FormatFile ExtensionBest For
Word (DOCX).docxEditing in Word, Pages, Google Docs
Markdown.mdTechnical docs, GitHub wikis, static sites
HTML.htmlWeb publishing, email templates
JSON (ADF).jsonBackups, data processing, re-importing to Confluence
XML.xmlData interchange, structured content processing

Import Formats​

FormatNotes
Word (DOCX)Headings, lists, tables, images preserved
MarkdownBasic formatting converted to Confluence format
HTMLWeb content converted to Confluence format
JSON (ADF)Best compatibility — native Confluence format
XMLStructured content converted to Confluence format
Excel (XLSX)Spreadsheet rows imported as table data
CSVComma-separated data imported as table content
ZIPBundle of files — folder structure preserved

What Gets Preserved​

  • Headings, paragraphs, lists (ordered and unordered, including nested)
  • Tables with rows and cells
  • Bold, italic, and other text formatting
  • Links and images (including inline images from Word documents)
  • Panels and info blocks
  • Folder hierarchy (when importing ZIP archives)

Best Practices​

Before Exporting​

  • Start with a small test export (5-10 pages)
  • Check that you have access to the source spaces
  • Choose formats based on your use case:
    • Re-importing to Confluence? Use JSON
    • Editing in Word? Use DOCX
    • Publishing online? Use HTML or Markdown

Before Importing​

  • Back up existing content if using override mode
  • Test with a non-critical space first
  • Use JSON format for best compatibility
  • Keep individual files under 10 MB

For Large Operations​

  • Export in batches of 50-100 pages
  • Export each space separately for better organization
  • Close other browser tabs during large operations
  • Use a stable internet connection

Troubleshooting​

Export Issues​

Export fails with "Permission denied"

  • Verify you have read access to the selected spaces
  • Check space permissions in Confluence settings

Images missing from export

  • Ensure the page actually has attached images
  • Check that images are Confluence attachments (not external URLs)
  • The export manifest includes attachment debug info — check export-manifest.json

Downloaded ZIP is corrupted

  • Retry the export
  • Check your internet connection
  • Try exporting a single format instead of multiple

DOCX looks wrong in Word/Pages

  • Body text should render at 11pt — if not, ensure you're using the latest app version
  • Complex macros and layouts may be simplified

Import Issues​

Import fails with "Invalid format"

  • Verify the file format is supported (JSON, Markdown, HTML)
  • Check the file isn't corrupted
  • For ZIP imports, ensure files inside are in supported formats

Content looks different after import

  • Some formatting may not translate perfectly from Markdown/HTML
  • JSON (ADF) format gives the best results for Confluence re-import

FAQ​

Can I export images and attachments? Yes. Images attached to Confluence pages are downloaded and bundled in an attachments/ folder inside the export ZIP for all formats.

Can I import folder structures? Yes. Upload a ZIP file and the folder hierarchy is preserved. You'll see a tree preview before confirming the import.

What's the maximum number of pages I can export at once? We recommend batches of 50-100 pages for optimal performance. Larger batches may be slower but will complete.

Can I export from multiple spaces at once? Yes. Select content from multiple spaces and export everything together. The ZIP is organized by space.

Are page permissions preserved? No. Permissions are not exported/imported. Set permissions manually after importing.

Does it work in dark mode? Yes. The app follows your Confluence theme — light or dark.

Can I cancel an export/import? Currently operations run to completion. Plan exports in manageable batches.

Version: 3.1.0 Last Updated: May 2026