Import from Confluence
The Confluence importer migrates Confluence spaces and their pages into SetGet pages. Page hierarchy, content formatting, and inline images are preserved during migration. This importer is designed for teams moving their documentation and knowledge base from Confluence to SetGet.
What gets imported
| Confluence element | SetGet equivalent | Notes |
|---|---|---|
| Space | Project pages section | Pages imported under a parent page named after the space |
| Page | SetGet page | Content converted from Confluence storage format |
| Page hierarchy | Nested pages | Parent-child relationships preserved |
| Inline images | Embedded images | Re-uploaded to SetGet storage |
| Attachments | File assets | Re-uploaded to SetGet storage |
| Page labels | Page tags | Mapped if supported |
Prerequisites
- A Confluence Cloud instance or Confluence Server/Data Center with API access.
- A Confluence account with read access to the spaces you want to import.
- Admin or Owner role in your SetGet workspace.
Setup steps
Step 1 -- Connect to Confluence
- Go to Settings > Import.
- Select Confluence.
- Enter your Confluence instance URL (e.g.,
https://yourcompany.atlassian.net/wiki). - Enter your email and API token.
- For Confluence Cloud, generate a token at id.atlassian.com/manage-profile/security/api-tokens.
- For Confluence Server, use a personal access token.
- Click Connect.
Step 2 -- Select the space
- SetGet lists all accessible spaces.
- Select the space you want to import.
- SetGet scans the space and shows: page count, hierarchy depth, attachment count.
Step 3 -- Choose the target project
Select the SetGet project where imported pages will be stored. Pages are added to the project's pages section.
Step 4 -- Configure options
| Option | Description | Default |
|---|---|---|
| Preserve hierarchy | Maintain parent-child page structure | On |
| Import attachments | Re-upload attached files | On |
| Import page labels | Convert labels to page tags | On |
| Import archived pages | Include pages in the archive | Off |
Step 5 -- Start import
Click Start Import and monitor progress. Large spaces with many pages and attachments may take several minutes.
Content conversion
Confluence storage format (XHTML) is converted to SetGet's editor format. The following elements are supported:
| Confluence element | SetGet rendering |
|---|---|
| Headings (h1-h6) | Headings |
| Paragraphs | Paragraphs |
| Bold, italic, underline | Text formatting |
| Bulleted lists | Bulleted lists |
| Numbered lists | Numbered lists |
| Tables | Tables |
| Code blocks | Code blocks with syntax highlighting |
| Images | Inline images |
| Links | Hyperlinks |
| Info/warning panels | Callout blocks |
WARNING
Confluence macros (e.g., Jira issue macro, Table of Contents macro, custom macros) are not converted. They appear as placeholder text in the imported page. Review imported pages for macro placeholders and recreate the content manually.
Post-import validation
- Verify the page count matches the Confluence space.
- Check that the hierarchy (parent-child nesting) is correct.
- Open several pages to verify formatting and images.
- Confirm attachments are accessible.
Multi-space import
To import multiple Confluence spaces:
- Run the importer once for each space.
- Choose the same or different target projects depending on your structure.
- Pages from different spaces are kept separate by project or by parent page.
TIP
If you have a large Confluence instance with many spaces, prioritize the most active spaces first. Archive inactive Confluence spaces rather than importing them.
Confluence vs. SetGet pages
| Feature | Confluence | SetGet |
|---|---|---|
| Page hierarchy | Unlimited nesting | Unlimited nesting |
| Rich text editing | Atlassian editor | SetGet block editor |
| Macros | 100+ macros | Slash commands and embeds |
| Comments | Page comments and inline comments | Page comments |
| Versioning | Full version history | Full version history |
| Permissions | Space and page level | Project level |
| Search | Global search | Global search |
After migrating, your team will find the SetGet page editor familiar. The main difference is that Confluence macros need to be recreated using SetGet's slash command system (e.g., /table, /code, /diagram).
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Connection fails | Wrong URL or credentials | Verify instance URL and API token |
| Space not listed | Insufficient permissions | Use an account with space read access |
| Images missing | Private attachments | Ensure the API token account can access the images |
| Macros showing as text | Expected behavior | Recreate macro content manually |
| Hierarchy flat | Option disabled | Enable "Preserve hierarchy" |
| Large space timing out | Too many pages | Import in batches by selecting subsets |