# RSS Feeds

In addition to REST APIs, Weavestream can pull in data from RSS and Atom feeds. This is great for monitoring news sources, blogs, release notes, or any site that publishes a feed.

# Adding an RSS Category

RSS feeds are organized into categories (similar to how API endpoints are organized under sources). To get started:

1. Click the + button at the bottom of the sidebar
2. Choose Add RSS Category
3. Give your category a name (e.g., "Tech News," "Release Notes," "Industry Blogs")
4. Pick an icon and color
5. Set a refresh interval

# Adding a Feed

Once you have a category, you can add feeds to it:

1. Hover over the RSS category in the sidebar and click the ... menu
2. Choose Add Feed

# Feed URL

Enter the URL of the RSS or Atom feed and click Validate URL. Weavestream will fetch the feed and confirm it's valid. If successful, you'll see the number of items found.

# Feed Name

Give the feed a name, or use the auto-detected title from the feed itself. If a title is detected, you'll see a suggestion you can click to use it.

# Settings

• Item Limit — The maximum number of items to keep from this feed (10 to 500). Older items beyond this limit are removed during sync.
• Retention Mode — Controls what happens to items during sync:
  • Keep All — Items are kept indefinitely (up to the item limit)
  • Delete on Sync — Items not present in the latest feed are deleted
  • Archive on Sync — Items not in the latest feed are archived (hidden but preserved)

# Field Mappings

Weavestream needs to know which feed fields map to the title, summary, body, date, and ID of each item. You have two options:

Use presets: Click RSS 2.0 Defaults or Atom Defaults to auto-fill standard mappings:

Custom mapping: If your feed uses non-standard field names, select from the discovered fields or type a custom field name.

# Managing Feeds

From the sidebar, you can manage individual feeds:

• Right-click a feed to access:
  • Edit Feed — Change the URL, name, or settings
  • Sync Feed — Refresh just this feed
  • Enable/Disable — Temporarily stop syncing without deleting
  • Delete Feed — Remove the feed and its items

To manage the category itself, use the ... menu on the category:

• Sync Now — Refresh all feeds in this category
• Edit Category — Change the name, icon, or color
• Delete Category — Remove the category and all its feeds

# Browsing RSS Items

RSS items appear in the item list just like API items. You can:

• Search across feed content
• Sort by date or title
• Mark items as read/unread
• Flag important items
• Archive items you're done with

RSS items also work with Smart Filters and AI Analysis, so you can combine them with your API data or analyze them independently.

# Next Steps

• Syncing & Refresh — Control sync timing
• Searching & Sorting Items — Find items quickly
• Smart Filters — Create custom views across feeds and APIs