# Add files and apps to Knowledge

> Connect Drive, Gmail, Slack, GitHub, Jira, or Confluence to add its content to Knowledge. Add files, then check, narrow, pause, retry, or remove a source.

Source: https://tulipfarm.ai/docs/knowledge/add-to-knowledge/

This guide shows you how to build your Knowledge, the knowledge base that your chats and agents search and cite. You connect apps, add files and notes, and then manage each source. To learn what happens to the content, read [How Knowledge works](https://tulipfarm.ai/docs/knowledge/how-knowledge-works/index.md).

Everything you add is private to you. Your chats and agents can search it. Other people can't.

## Connect an app

When you connect Google Drive, Gmail, Slack, GitHub, Jira, or Confluence, TulipFarm adds that app's content to your Knowledge automatically.

1. In the sidebar, under **Data & integrations**, select **Knowledge**.

2. Find the app and select **Connect**. Or select **Manage integrations** to choose from every app.

3. Sign in to the app and allow access.

4. Open the app on the **Integrations** page and select the **Knowledge** tab.

5. Read **What gets imported**. It lists what is included, who can search it, the time range, and what is left out.

6. Wait until the status shows **Sync complete**. Before that, it can show **Queued for indexing**, **Finding sources**, or **Partly searchable**. You can ask questions about the content that is already searchable.

To stop adding new content from an account, select **Stop automatic Knowledge**, then **Confirm stop**. Content that TulipFarm already added stays until you pause or remove its sources. To start again, select **Turn automatic Knowledge back on**.

## Google Drive

Automatic Knowledge adds every Drive file that you can open, including files added later. For details, see [Google](https://tulipfarm.ai/docs/integrations/google/index.md).

To add a single folder or a shared drive yourself:

1. Open **Google Drive** on the **Integrations** page, then the **Knowledge** tab.

2. Select **Index Google Drive**.

3. Under **Source type**, select **My Drive or a folder**, or **Shared drive**, and choose the folder or drive.

4. Select **Save Google source**.

A folder in Google Drive can be a Knowledge source. A folder in **Files** can't. See [Add a file from Files](#add-a-file-from-files).

## Gmail

Automatic Knowledge adds mail from the last 90 days, including new mail. Older mail leaves Knowledge as the 90 days move on. Spam, Trash, and attachments are not added. For details, see [Google](https://tulipfarm.ai/docs/integrations/google/index.md).

To add a label or an older date range yourself:

1. Open **Gmail** on the **Integrations** page, then the **Knowledge** tab.

2. Select **Index Gmail**.

3. Choose a label, or the whole mailbox.

4. Set **After date** and **Before date**. The range can be up to 366 days.

5. Select **Save Google source**.

## Slack

Automatic Knowledge adds messages from the last 90 days in the public and private channels you joined, including channels you join later. TulipFarm never joins a channel for you. Direct and group messages are not added unless you add them yourself. For details, see [Slack](https://tulipfarm.ai/docs/integrations/slack/index.md).

To add direct messages, group messages, or older channel history:

1. Open **Slack** on the **Integrations** page, then the **Knowledge** tab.

2. Select **Select Slack conversations**.

3. Under **Conversation type**, select **Public and private channels**, or **Direct and group messages**.

4. Choose up to 50 conversations.

5. Set **Import messages after** to the earliest date you want.

6. Select **Save Slack source**.

## GitHub

Automatic Knowledge adds every repository that your GitHub account can read, including new ones. It adds docs and code from the default branch, the default branch's commit history, and issues, pull requests, and discussions that were active in the last 90 days. For details, see [GitHub](https://tulipfarm.ai/docs/integrations/github/index.md).

To leave out repositories or kinds of content:

1. Open **GitHub** on the **Integrations** page, then the **Knowledge** tab.

2. Find the source under **Repositories in Knowledge** and select **Edit settings**.

3. Under **Repositories**, clear each repository that you want to leave out. It stays out until you select it again.

4. Under **Content**, clear the kinds of content that you want to leave out, such as commits or discussions.

5. Select **Save source settings**.

To add a separate source with only the repositories you choose, select **Add repositories**, choose them, then select **Add to Knowledge**.

## Jira and Confluence

Automatic Knowledge adds the issues in every Jira project, and the pages in every Confluence space, that you can see on each connected site. New projects and spaces are added too. For details, see [Jira, Confluence, and Trello](https://tulipfarm.ai/docs/integrations/jira-confluence-trello/index.md).

Knowledge uses a separate Atlassian sign-in from the Jira and Confluence tools. The first time, open the **Knowledge** tab and select **Allow Knowledge access**.

To add specific projects, spaces, or pages yourself:

1. Open **Jira** or **Confluence** on the **Integrations** page, then the **Knowledge** tab.

2. Select **Select Jira content** or **Select Confluence content**.

3. Choose the **Atlassian site**.

4. Choose up to 50 projects, spaces, or pages. For Confluence, under **Import**, select **Whole spaces** or **Specific pages**. To add the pages under a page, select **Include child pages**.

5. Select **Save Jira source** or **Save Confluence source**.

## Add a file from Files

1. Open **Files** and open the file.

2. Select **Add to Knowledge**.

3. Select **Add to Knowledge** in the dialog.

4. Wait for the message "Ready. Chats can use it from your Knowledge."

You can add up to 20 files at a time. You can't add a folder from **Files**. Select the files in it instead.

TulipFarm saves the text of the file as it is now. It doesn't follow later edits. If a file fails, the message says why, such as a password-protected file. After you fix the problem, select **Retry extraction**. For the file types and limits, see [Knowledge sources and limits](https://tulipfarm.ai/docs/knowledge/sources-and-limits/index.md).

## Add a note

1. In a chat, ask TulipFarm to save a note to your Knowledge. For example: "Save a note that our returns window is 30 days."

2. Read the **New note** card that appears in the chat.

3. Select **Add to Knowledge**.

Nothing is saved until you select **Add to Knowledge**. To change or delete a note later, ask in a chat. The card shows **Update** or **Remove** for you to approve.

## Pause, resume or retry a source

The **Knowledge** page shows each connected app and its status. To manage a whole app:

1. In the sidebar, under **Data & integrations**, select **Knowledge**.

2. Open the actions menu next to the app.

3. Select **Pause syncing** or **Resume syncing**. If the status shows a failure, select **Retry**.

To manage one source, open the app's **Knowledge** tab and find the source. Then select **Pause source**, **Resume source**, **Retry source**, or **Remove source**. To confirm a removal, select **Confirm remove source**. Removing a source takes its content out of Knowledge. The original stays in the app.

A paused or removed source stays that way. TulipFarm doesn't add it back when it looks for new content.

> **Note:** If the status shows **Needs authorization**, reconnect the account on the **Accounts** tab, then select **Retry now**. If it shows **Limit reached**, the workspace has used its Knowledge credits or limits. Content already added stays searchable, and new content waits. See [Knowledge sources and limits](https://tulipfarm.ai/docs/knowledge/sources-and-limits/index.md#limits).

## Related

- [How Knowledge works](https://tulipfarm.ai/docs/knowledge/how-knowledge-works/index.md)
- [Knowledge sources and limits](https://tulipfarm.ai/docs/knowledge/sources-and-limits/index.md)
- [Connect your apps](https://tulipfarm.ai/docs/integrations/index.md)
- [Manage files](https://tulipfarm.ai/docs/guides/manage-files/index.md)
