Skip to main content

Notion

Introduction to the Feature​

Integrate Notion with Catalog to enable seamless synchronization of data documentation content. This integration ensures:

  • A constantly updated and comprehensive knowledge base for the Data Governance Team
  • A powerful AI Assistant that utilizes the content to provide the best responses to your questions

Why Synchronize Your Notion Pages in Catalog?​

Advantage 1: Enhanced AI Assistant Intelligence​

All imported content feeds the Assistant, significantly boosting its intelligence. This empowers your teams to gain independence and efficiency in their work.

Advantage 2: Always Up-to-Date Content​

Currently, users manually copy and paste content from Notion into Catalog, leading to redundant maintenance efforts and potential inconsistencies. With this feature, these issues are eliminated. The synchronized content becomes the single source of truth, always up-to-date and read-only in Catalog.

How to Perform the Synchronization​

Follow these steps to set up the integration:

  1. Navigate to the integration page (as an admin)

    Location: Your Internal Notion Space

  2. Name the integration and sync it with the workspace

    Location: Your Internal Notion Space

  3. Grant permissions and copy the Internal Integration Secret token

    Location: Your Internal Notion Space

  4. Connect to a page

    Location: Your Internal Notion Space

  5. Verify the page's appearance when the integration is properly connected (and how to disconnect if needed)

    Location: Your Internal Notion Space

  6. Complete the integration process

    Location: In Catalog

    Start the synchronization process by clicking on the Notion icon. You will need to enter your credentials.

FAQ​

Questions About Page Synchronization​

  1. Q: If I select a parent page, are all its children automatically ingested? A: Yes, all child pages are automatically ingested.
  2. Q: If I want to select only one child page out of 10 ingested, do I need to "desynchronize" the other 9? A: Yes, you'll need to manually desynchronize the unwanted child pages. Or, you directly synchronise the good one in the first place.
  3. Q: How can I ingest only a single page without its children? A: You need to manually desynchronize its child pages.
  4. Q: What are the ingestion rules for private pages? A: Private pages within a public parent page are ingested. To prevent this, manually desynchronize the private pages.

Questions About Rights and Permissions​

  1. Q: Are the permissions on Notion pages reflected in Catalog? A: No, not currently. If User A doesn't have rights to view a page in Notion, but that page is synchronized to Catalog and User A has access to Catalog, they will be able to see the page content. This content will also be used by the AI Assistant.