Docvora Documentation
Docvora Website Features Pricing Contact Us
Get 50% off your first three months for a limited time! Find out more.
Getting Started IconGetting Started

Docvora Documentation / Getting Started / Migrating from Confluence

Updated

Migrating from Confluence

By Docvora Assistant 3 mins 4

Docvora supports importing existing documentation from Confluence Cloud, allowing organisations to migrate their knowledge bases without manually recreating pages and content.

The migration process supports transferring Confluence spaces, including their page structure, formatting, images and attachments.

Existing content within Confluence is not modified during the migration.

Before Getting Started

To begin migrating from Confluence Cloud, the following information is required:

  • Confluence site URL: The address of the Confluence Cloud instance, such as your-team.atlassian.net.

  • Atlassian account email: The email address associated with an Atlassian account that has access to the spaces being migrated.

  • Atlassian API token: An API token generated through the Atlassian account to authorise access to the existing documentation.

The Atlassian account must have access to all spaces intended for migration. Read-only permissions are sufficient when generating a scoped API token.

Docvora only uses the provided API token for the migration process and does not store it.

Generating an Atlassian API Token

An API token is required to allow Docvora to access existing Confluence documentation.

  1. Visit Atlassian Account Management.

  2. Navigate to Security.

  3. Select API tokens.

  4. Create a new API token with the permissions required to read the Confluence content being migrated.

  5. Copy the generated token for use during the migration.

API tokens should be kept secure and should not be shared outside the migration process.

Migrating to Docvora

Step 1: Connect to Confluence

  1. Open the Docvora Staff Panel.

  2. Navigate to Migration Tools.

  3. Select Import from Confluence.

  4. Enter the Confluence site URL in the Confluence site field. The main site address or a copied link from the site can be used.

  5. Enter the email address associated with the Atlassian account.

  6. Paste the generated API token into the API token field.

  7. Select Find spaces to retrieve the available Confluence spaces.

The supplied Atlassian account must have permission to view the spaces intended for migration.

Step 2: Select Spaces

  1. Tick each Confluence space to import. Personal spaces aren't listed.

  2. For each space, choose **Import into**: **A new space**, or an existing Docvora space to add its pages to. A Confluence space's home page becomes the new space's own content.

Step 3: Import Documentation

  1. Choose the import options. **Import as hidden** keeps the imported content out of navigation and search until it's checked. **Images and attachments** downloads the files used on each page. **Archived pages** also brings across pages archived in Confluence.

  2. Select **Start import**. The import's page shows its progress, and the import keeps running if the page is closed.

  3. When the import finishes, check the pages, then select **Publish imported pages**.
    See Import Options & Progress for every option.

Supported Content

The Confluence migration tool supports importing the following content:

  • Confluence Cloud spaces

  • Page hierarchy and structure

  • Page formatting

  • Images

  • Attachments

The migration process is designed to preserve the existing organisation and content of Confluence documentation when transferring it to Docvora.

Need Assistance?

For assistance with migrating from Confluence, the Docvora support team can provide guidance throughout the process.

Visit the Docvora Contact Page to get in touch.