ClickHelp Documentation

Import a Space from Confluence

In ClickHelp, you can import your Confluence Space directly without the need to export it into any output format beforehand.

This topic describes importing a Space from Confluence Server, Cloud, and Data Center editions.

Note

Most of the steps are the same for all Confluence editions. On the steps where actions differ, you will find collapsible blocks marked with the edition names containing instructions for the specified editions.

  1. Open the Author Dashboard and click the Import Document button.
    The Import Document button on the Author Dashboard
  2. In the Import Project Wizard, select Confluence, and specify where to import the content: create a new project or add the topics to an existing project. In ClickHelp, a Project is a Confluence Space analog.
    Select Confluence in the Import Project Wizard
  3. If creating a new project, give it a name in the Project name box, specify the Project language, and click Next. The Confluence Login step opens.
    Important
    Since you cannot change a project's language after its creation, it's important to set the correct language during the project's creation.
  4. Select the Confluence edition from the three available options, depending on the one you import from.
  5. In the Confluence portal URL box, enter your portal URL. 
    Tip
    If you're unsure about the portal URL, insert any link to your Confluence instance — like a link to a page or a space. ClickHelp will try to recognize the portal URL automatically.
  6. In the Confluence login box, enter your Confluence login.
    Fill in the three fields with your Confluence credentials in the Import Project Qizard
  7. Confluence Server

    In the Confluence password box, enter your Confluence password.

    Confluence Cloud / Data Center 

    In the Confluence API token box, enter your API token. Learn how to get your API token here: Manage API tokens for your Atlassian account | Atlassian Support 

  8. Click NextConfluence Settings step of the Import Project Wizard opens.
  9. Select the Confluence Space you want to import in the Space name dropdown list.
  10. If you have the Scroll Versions plugin installed in your Confluence Server instance, the Space version (Scroll Versions) list becomes available where you need to select the version of the chosen Space you want to import. Refer here to learn more: Confluence Import Specifics.
  11. Select how ClickHelp should handle the unsupported macros during the import: remove unsupported macros or replace unsupported macros with placeholders. Learn the details about both options in the following topic: Importing Confluence Macros.
  12. Click Next and wait until the import process is finished.
  13. Click Finish.