Confluence Datacenter Airdrop

Confluence Datacenter Airdrop helps you migrate your team’s knowledge and documentation from Confluence Datacenter into DevRev. It acts as a bridge that transfers content, attachments, user associations, and structure while supporting both one-time imports and ongoing syncs.

Key features

• Import pages and blog posts
• Preserve document and folder hierarchy
• Transfer file attachments
• Maintain user and group relationships

Why use this feature

You may want to use this tool to:

• Import knowledge base articles and documentation from Confluence into DevRev
• Include attachments from pages and blogs
• Maintain user identities and group associations
• Preserve the folder structure and content hierarchy

Supported objects

What to expect during your first import

1. Preparation

Make sure you have access to your Confluence Datacenter instance and DevRev account.

To install the DevRev plugin on Confluence:

1. Go to your Confluence instance.
2. Go to Settings > Manage Apps.
3. Click Upload App.
   • If the Upload App button is not visible on the UI, please follow the instructions in Enabling the Upload App Button.
4. Add this URL https://marketplace.atlassian.com/artifacts/7ff2bf70-2a87-4205-a337-52f594afe4db/download.

2. Installation and setup

Continue with the steps described in the Importing from Confluence section.

3. Attachment consideration

All attachments are imported. Depending on the size and number, this may increase total import time.

4. Secure connection

Create a Personal Access Token (PAT) in your Atlassian account to connect Confluence with DevRev.

5. Selective import

You can select specific Confluence spaces for import, giving you control over what is brought into DevRev.

6. Import duration

• Small spaces may take seconds
• Large spaces with thousands of documents and attachments may take hours

7. Results and review

After the import completes, a detailed report shows all imported pages, blogs, attachments, users, and folders.

⚠️ Sync is one-way only, from Confluence to DevRev. Changes made in DevRev do not sync back to Confluence, and syncing may overwrite DevRev customizations.

Setting up the Confluence Datacenter connection

1. Go to your Atlassian profile settings.
2. Go to Personal Access Tokens.
3. Generate a PAT (Personal Access Token).
4. Use this token when creating a connection in DevRev.

Importing from Confluence

1. In DevRev, go to Settings > Integrations > Snap-ins.

2. Search for Confluence Datacenter Airdrop.

3. Click Add and then Install.

4. Go to Integrations > Airdrop.

5. Click Start Airdrop, then choose Confluence.

6. Click Add Connection, then fill in the following:

   • Connection Name – a friendly label for this connection
   • Subdomain – your Confluence domain (for example, yourdomain.atlassian.net)
   • PAT Token – the token you generated from Atlassian

7. After establishing the connection, select the Confluence spaces you want to import.

8. Map them to the appropriate DevRev parts.

9. Review the auto-configured field mappings and proceed through each screen.

10. Once the extraction is complete, view the report showing imported objects:

    • Pages
    • Blogs
    • Users
    • Attachments
    • Folders

Post-import options

After a successful import, you can:

🔁 Sync to DevRev

Push updates or new content from Confluence into DevRev:

• Go to Settings > Integrations > Airdrops.
• Find the imported space.
• Click ⇆ > ⇾ From Confluence to DevRev.

⚠️ A sync may overwrite any edits made in DevRev to previously imported items.

📄 View report

Access a detailed report of the initial import and any subsequent syncs.

🗑 Delete import

Remove the imported content from DevRev and delete the record of the import.

⚙️ Edit connection

Update or replace the PAT and other connection settings if the original connection becomes inactive.

Limitations

While most major components are supported, the following are not:

• Comments on pages or blogs
• Page reactions (likes, emojis)
• Sorting on tables (tables become static in DevRev)
• Publicly shared Confluence links (anonymous content cannot be tracked or mapped)

Enabling the upload app button

If you do not see the Upload App button in Confluence Datacenter, it may be due to permission restrictions or feature disablement by your admin. To enable it:

1. Ensure you are logged in as a Confluence Administrator.
2. Go to Administration > Add-ons > Upload App.
3. If the button is still not available:
   • Contact your system administrator to enable Plugin Uploads
   • Alternatively, update the system properties to allow manual app uploads:
     • Set the following flag in your Confluence configuration:

       1 plugin.upload.enabled=true
       

ℹ️ For more details, refer to Atlassian's official documentation or contact your organization's Confluence administrator.

A one-time sync may overwrite fields in previously imported items, even if they were modified in DevRev.

Historical Airdrops

To view currently running and previous Airdrops from various sources, do the following:

1. Go to Settings > Integrations > Airdrops.
2. Select the import you want to view.
3. Click on the context menu (⋮) and select View Report.

Periodic sync

After successfully importing to DevRev, you have the option to enable a periodic sync. This allows for automatic synchronization with DevRev on a regular basis. By default, the sync occurs once an hour.

To configure periodic sync, follow these steps:

1. Go to Settings > Integrations > Airdrops.
2. Locate the previously imported project.
3. Select the ⋮ > Set Periodic Sync option.

The Enable automations for synced items setting is optional and can be activated during periodic sync configuration. When enabled, newly created or updated items trigger events, which can initiate webhooks, notifications, Snap-ins, and other processes, as if the events originated directly in DevRev.

If this setting is disabled, updates will not trigger any event-driven processes. This behavior applies only to periodic syncs; no events are triggered during a first-time import or manual sync to or from DevRev.

Delete import

This deletes any content created by the import, including users and works.

An import and all the content it creates can be deleted from DevRev. This can be useful when running POCs or to change the recipe used during the import. Once an import has been deleted, all the content it created gets deleted, even if they were modified in DevRev. It's possible to import the project again after its deletion.

To delete an import and all the content it created, go to Settings > Integrations > Airdrops, find the previously imported project, and select ⋮ > Delete Import.