# RSS

> Start workflows when a feed publishes something new.

Built-in step · 1 step. Web page: https://docs.lodol.com/docs/integrations/built-in/rss

## Steps

### New feed item

Start this workflow whenever a new item appears in an RSS, Atom or JSON feed: a blog post, a news story, a podcast episode, a video or a release. Each new item starts its own run, with the item's title, link, author, date, summary and content.

**Inputs**

- Feed address (`feed_url`, text, required): The address of the RSS, Atom or JSON feed to watch, e.g. https://example.com/feed.xml. Use the feed's own address, not the website's home page.
- Only items mentioning (`contains`, text): Only start a run for items whose title, summary, content or author mention this word or phrase. Capitals are ignored.

**Outputs**: The new item. Dates are in UTC (e.g. 2026-10-13T09:30:00Z); 'content' is the item's body as plain text and 'content_html' the same body as HTML. An item whose feed gives no date, author or image has that field empty.

- `author` (text)
- `categories` (list)
- `content` (text)
- `content_html` (text)
- `enclosure_type` (text)
- `enclosure_url` (text)
- `feed_title` (text)
- `feed_url` (text)
- `id` (text)
- `image_url` (text)
- `link` (text)
- `published` (text)
- `summary` (text)
- `title` (text)

**Example output**

```json
{
  "author": "Ana Lima",
  "categories": [
    "Product",
    "Beta"
  ],
  "content": "Today we are opening the beta to everyone on the waitlist. \u2026",
  "content_html": "<p>Today we are opening the beta to everyone on the waitlist.</p>",
  "enclosure_type": "",
  "enclosure_url": "",
  "feed_title": "Example Blog",
  "feed_url": "https://example.com/feed.xml",
  "id": "https://example.com/blog/launch-day",
  "image_url": "https://example.com/images/launch.png",
  "link": "https://example.com/blog/launch-day",
  "published": "2026-10-13T09:30:00Z",
  "summary": "Today we are opening the beta to everyone on the waitlist.",
  "title": "Launch day"
}
```
