---
title: Handling Data Sources
description: How to add, rename, preview, and delete custom data sources, and how to use the wizard and suggestion features to find the right source quickly.
---

# Handling Data Sources

The [News → Data Sources]({APP_HOST}/documents/datasources/definitions) page lists all custom online data sources in your organization. From here you can add new sources, preview their content, rename them, and delete them.

## Adding a Data Source

Click **+ Add** to open the data source wizard. The wizard guides you through two steps: choosing the type and configuring the details.

### Step 1 — Choose the Type

The type selection step gives you three ways to find the right data source:

**Search or suggest by keyword or URL**

Type a keyword or paste a URL into the search box and click **Search** (for keywords) or **Suggest** (for URLs). The platform launches an AI-powered suggestion job that analyzes your input and recommends matching data sources — including built-in ones from its library of 100+ preconfigured sources.

A suggestion dialog opens. You can refine your query and browse results. Clicking a suggested source adds it directly without going through the remaining wizard steps.

**Pick manually from the list**

The type list is organized into categories:

- **Web** — Google Site, RSS, Atom, WordPress, Google Custom Search, Telex
- **AI-enhanced** — AI Web Page Reader (Beta), Combined (Beta)
- **Social** — Facebook Page, Facebook Profile, YouTube Channel, Reddit Subreddit, Reddit User, TikTok User, Instagram User, Polymarket Event
- **Technology** — GitHub Repository
- **Corporate** — Microsoft Outlook, OneDrive, Entra, Gmail, Google Drive (coming soon)

Click the tile for the type you want. The wizard advances to the Details step.

See [Data Source Types](data-source-types) for a description of each type.

### Step 2 — Fill in the Details

Enter the details required for the selected type. Every type requires a **Name** and an optional **Description**. The remaining fields depend on the type:

| Type | Required input |
|---|---|
| Google Site | Domain name (e.g. `example.com`) |
| RSS / Atom | Feed URL |
| WordPress | Site URL |
| Google Custom Search | Search engine ID |
| Telex | Section (super-tag) and/or tag |
| AI Web Page Reader | Page URL; optionally a language model and additional instructions |
| Combined | Select two or more existing data sources to merge |
| Facebook Page / Profile | Page or profile slug (e.g. `bbc`) |
| YouTube Channel | Channel ID |
| Reddit Subreddit | Subreddit name |
| Reddit User | Username |
| TikTok User | Username |
| Instagram User | Username (slug) |
| Polymarket Event | Event slug from the Polymarket URL |
| GitHub Repository | Owner and repository name |

Click **Add** to save the data source. It appears in the list immediately and is available to all members of your organization.

## Previewing a Data Source

For data sources that support the **Latest** capability, a **Preview** button appears in the list. Clicking it starts a background job that fetches up to five of the most recent documents from that source. A dialog shows the results — titles, dates, and content excerpts — so you can verify the source is returning the content you expect before using it in searches or dashboards.

## Searching the List

When you have more than one data source, a search box appears at the top of the list. Type any part of a data source name to filter the list instantly.

## Renaming a Data Source

1. Find the data source in the list.
2. Click **Rename** (pencil icon).
3. Enter the new name and click **Save**.

The new name is reflected everywhere the data source appears, including in the search module and dashboards.

## Deleting a Data Source

1. Find the data source in the list.
2. Click the **Delete** (bin) button.
3. Confirm the deletion in the prompt.

Deleting a data source removes it permanently. Any dashboards, searches, or alert rules that referenced it will no longer have access to its content.