Adding a Confluence Cloud Source

You can add the content of a Confluence Cloud instance to your Coveo Cloud Organization. The source can be shared or private (see Source Permission Types).

Because you cannot install plugins in Confluence Cloud, Coveo cannot include permissions for this content and cannot perform source refreshes.

By default, a Confluence Cloud source starts a rescan every hour to retrieve Confluence Cloud item changes (addition, modification, or deletion).

If you change the name of a space in Confluence Cloud, the full refresh detects the change only for pages created or modified following the change. You must thus rebuild the source to get the space name change on all space pages (see Rebuild a Source).

Source Features Summary

Features Supported Additional information
Confluence Cloud version Latest cloud version
Searchable content types

Spaces, pages (such as Wiki pages), blog posts, comments on pages and blog posts (included as metadata), and attachments (in pages, blog posts, and comments)

Content update

Incremental refresh

Rescan or rebuild needed to retrieve deleted, restored, and moved items, and items with modified comments or permissions.

Full refresh
Rebuild
Permission types Secured

Private
Shared

Add a Confluence Cloud Source

To edit a Confluence Cloud source, see Edit the Source Configuration to Re-index its Content or Re-authorize the Access, and then follow the steps below, starting from step 5.

  1. Ensure your environment meets the following requirement:

    • Atlassian Confluence Cloud
  2. If not already done, log in to your Coveo Organization.

  3. In the navigation bar on the left, under Search Content, select Sources, and then click Add Source.

  4. In the Add Source page, click Confluence Cloud.

    When you create a source, you become the owner of the source.

  5. In the Add/Edit a Confluence Cloud Source dialog box, enter appropriate values for the following parameters:

    Admin-AddConfluenceCloudSource

    • Source name

      A descriptive name for your source under 255 characters (not already in use for another source in this organization).

      ConfluenceCloud-CorporateWiki

    • URLs

      One or more Confluence Cloud Wiki site and space addresses including the protocol (http:// or https://) that you wish to make searchable.

      Depending on your use case, use one of the following URL formats:

      • To index a complete Confluence Cloud site, add the Confluence server root URL:

        https://MyConfluenceServer.atlassian.net/wiki/

      • To index specific Confluence Cloud spaces, add their URL:

        • https://MyConfluenceServer.atlassian.net/wiki/display/space1

        • https://MyConfluenceServer.atlassian.net/wiki/display/space2

          where you replace MyConfluenceServer with your Confluence instance name, and space1 and space2 with the desired Confluence space keys.

    • Content to Include Section

    Consider changing the default value of the parameters in this section when you want to fine-tune how your Confluence Cloud site is crawled:

    • Space type

      Choose the Confluence Cloud space type(s) to include the content:

      By default, only global space content is included and personal space content is excluded.

      • Global

      • Personal

      • Both

    • Unselect one or more of the following Options when you want to prevent specific Confluence Cloud items from being included:

      • Attachments (binary files attached to a page, blog post, or comment)

      • Comments (on blog posts and pages)

    • Space Filter

      Enter a regular expression (regex) to filter spaces when you want to include only a subset of a Confluence site.

      This parameter is useful when you have a large number of spaces to include that have an element in common in their space keys.

      You want to include all spaces with keys starting with an uppercase letter followed by a number, so you enter the following regex:

      ^[A-Z][0-9].*$

    • Authentication Section

      • Username

        The username of a dedicated Confluence Cloud account who has access to all the content that you wish to include.

        Remember that Confluence Cloud permissions are not supported, so if you select the source content to be Shared, in search results, users can see all items that the dedicated account can access.

      • Password

        The corresponding password.

    • Security

      Select who can see items from this source in a search interface that includes this source in its scope (see Source Permission Types):

      • Shared: Everyone

      • Private: Only you, when you are authenticated to the search interface with the identity with which you create the source.

  6. Complete your source addition or edition:

    • Click Start Indexing to add the source content.

    • Click Refresh Index when you are done editing the source and want to make changes effective.

  7. Back in the Coveo Cloud administration console Sources page, you can review the progress of your Confluence source addition or modification (see Review the State of Sources Available to You).

What’s Next?