Detected country: US
logo
Open AppStatusSubmit Ticket
GuideAPI References
‌
‌
‌
logo

Powered by

  • Home
  • Knowledge
  • Managing your knowledge base
  • Migrating and Bulk-Importing Content

Migrating and Bulk-Importing Content

3min read

Share

Bulk Uploading Content to Brainfish: Your Comprehensive Guide

Efficiently populating your Brainfish knowledge base is crucial for maximizing its value. Whether you're migrating existing content or regularly updating your information, Brainfish offers several flexible methods for bulk uploading. This guide will walk you through each option, helping you choose the best approach for your needs.

How to Access Import

The Import feature is accessible via the account dropdown in the top-right navigation of the Brainfish app. Click your account/avatar icon in the top right and look for the Import option.

1. Direct Markdown (.md) with Brainfish Import

For a straightforward and native way to bring in your data, Brainfish provides a dedicated import feature. This method is ideal for general content migration and structured data.

How to Use:

  1. Open the account dropdown in the top-right navigation and navigate to Import.

  2. Select the "Brainfish Import" option.

  3. Drag in a folder filled with .md files and this will create them in bulk in the Brainfish platform.

    If you need a large amount of structured content imported, please reach out to the Brainfish team, as we offer a migration service as part of onboarding.

2. Seamless Integration with Notion

If your team extensively uses Notion for documentation and knowledge management, Brainfish offers a direct integration to streamline the import process.

How to Use:

  1. In Notion, click the top right 3 dots in any section > Export
  2. In Notion, choose the Export format: HTML and choose if you want any additional content exported. This should download a zip file to your desktop.
  3. Open the account dropdown in the top-right navigation and navigate to Import.
  4. Choose the "Notion Import" option.
  5. Drag in the exported HTML zip from your Notion database.
  6. Brainfish will then pull in the selected content, maintaining its structure where possible.

3. Importing from Zendesk

For businesses leveraging Zendesk as their customer support platform, Brainfish facilitates easy migration of your existing help articles and FAQs.

How to Use:

  1. Open the account dropdown in the top-right navigation and navigate to Import.
  2. Select the import from Zendesk option.
  3. Enter your Zendesk domain and choose the desired locale.

Migrating from Zendesk will mimic your folder, subfolder + article structure, and Brainfish will automatically import your embedded content like imagery, videos, tables and more.

If you enter your Zendesk email and a linked API token that you created, you'll be able to import all of your Internal Zendesk content too.

4. Programmatic Import via the Brainfish API

For developers and teams with specific, complex, or ongoing integration needs, the Brainfish API offers a powerful way to automate content uploads.

How to Use:

  1. Familiarize yourself with the Brainfish API documentation: Understand the available endpoints for content creation and management.
  2. Write a script: Using a programming language of your choice (e.g., Python, Node.js), develop a script that:
    • Authenticates with the Brainfish API.
    • Reads your content from its source (database, files, etc.).
    • Formats the content according to Brainfish's API requirements.
    • Makes API calls to create or update articles, sections, and other content elements in Brainfish.
  3. Test and deploy: Thoroughly test your script to ensure data integrity and then set it up for automated execution if needed.

5. Let the Brainfish Team Handle It For You

If you have a large volume of data, unique formatting requirements, or simply prefer a hands-off approach, the Brainfish team is here to help. We offer a white-glove service to assist with your bulk imports.

How to Engage:

  1. Reach out to our support team: Contact us via our website, email, or your dedicated account manager.
  2. Provide your content: Share your data in its current format, along with any specific instructions or desired structuring.
  3. Relax: Our experts will work with you to understand your needs and efficiently import all your content into Brainfish, ensuring everything is set up correctly.

No matter the size or complexity of your content, Brainfish provides a robust solution for bulk uploading. Choose the method that best fits your technical capabilities and operational workflow to get your knowledge base up and running quickly and effectively.

<!-- Reviewed by Theo Terdes, 2026-06-09 -->

Share