# Modern Importer & Exporter for Confluence - User Guide

## Table of Contents[​](#table-of-contents "Direct link to Table of Contents")

* [Introduction](#introduction)
* [Features Overview](#features-overview)
* [Getting Started](#getting-started)
* [Export Content](#export-content)
* [Import Content](#import-content)
* [Supported Formats](#supported-formats)
* [Best Practices](#best-practices)
* [Troubleshooting](#troubleshooting)
* [FAQ](#faq)

## Introduction[​](#introduction "Direct link to 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[​](#key-benefits "Direct link to 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[​](#features-overview "Direct link to Features Overview")

### Export[​](#export "Direct link to 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[​](#import "Direct link to 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[​](#two-ways-to-access "Direct link to 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[​](#getting-started "Direct link to Getting Started")

### Installation[​](#installation "Direct link to 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[​](#first-use "Direct link to 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[​](#export-content "Direct link to Export Content")

### From the Global Page[​](#from-the-global-page "Direct link to From the Global Page")

#### Step 1: Select a Space[​](#step-1-select-a-space "Direct link to 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[​](#step-2-choose-formats "Direct link to 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[​](#step-3-export "Direct link to 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[​](#whats-in-the-export-zip "Direct link to 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)[​](#from-the-content-action-quick-export "Direct link to 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[​](#import-content "Direct link to Import Content")

### From the Global Page[​](#from-the-global-page-1 "Direct link to From the Global Page")

#### Step 1: Upload Files[​](#step-1-upload-files "Direct link to 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[​](#step-2-choose-target-space "Direct link to 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[​](#step-3-review-and-confirm "Direct link to 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)[​](#from-the-content-action-quick-import "Direct link to 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[​](#supported-formats "Direct link to Supported Formats")

### Export Formats[​](#export-formats "Direct link to Export Formats")

| Format          | File Extension | Best For                                             |
| --------------- | -------------- | ---------------------------------------------------- |
| **Word (DOCX)** | `.docx`        | Editing in Word, Pages, Google Docs                  |
| **Markdown**    | `.md`          | Technical docs, GitHub wikis, static sites           |
| **HTML**        | `.html`        | Web publishing, email templates                      |
| **JSON (ADF)**  | `.json`        | Backups, data processing, re-importing to Confluence |
| **XML**         | `.xml`         | Data interchange, structured content processing      |

### Import Formats[​](#import-formats "Direct link to Import Formats")

| Format           | Notes                                             |
| ---------------- | ------------------------------------------------- |
| **Word (DOCX)**  | Headings, lists, tables, images preserved         |
| **Markdown**     | Basic formatting converted to Confluence format   |
| **HTML**         | Web content converted to Confluence format        |
| **JSON (ADF)**   | Best compatibility — native Confluence format     |
| **XML**          | Structured content converted to Confluence format |
| **Excel (XLSX)** | Spreadsheet rows imported as table data           |
| **CSV**          | Comma-separated data imported as table content    |
| **ZIP**          | Bundle of files — folder structure preserved      |

### What Gets Preserved[​](#what-gets-preserved "Direct link to 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[​](#best-practices "Direct link to Best Practices")

### Before Exporting[​](#before-exporting "Direct link to 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[​](#before-importing "Direct link to 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[​](#for-large-operations "Direct link to 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[​](#troubleshooting "Direct link to Troubleshooting")

### Export Issues[​](#export-issues "Direct link to 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-issues "Direct link to 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[​](#faq "Direct link to 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

Was this helpful?👍 Yes👎 No