Feed
Follow an RSS/Atom feed for new article notifications.
What it does
A Feed Source watches an RSS, Atom, or JSON Feed for new articles and sends you a notification for each new entry. You can use it to follow blogs, news outlets, release notes, or anything else that publishes a feed.
Before you start
You need one of two things:
- The website you want to watch; Prowl will offer any feeds the site advertises
- The address of a feed itself, such as
https://example.com/feed.xml
The feed itself must:
- Be RSS 2.0, Atom, or JSON Feed. RSS 1.0 (RDF) isn't supported.
- Use an
https://address that's reachable from the public internet.
Feed URLs are stored with at-rest encryption so that URLs containing secret tokens (like Patreon's members-only feeds) have an extra level of security.
Set it up
Enter either the address of the website or of the feed that you want to subscribe to. You can also give the Source an optional name and choose the priority for its notifications. Prowl will check the feed URL when you create the Source to confirm it works.
Check it works
After you add the feed, "Last checked" on the Source's page shows the last time Prowl fetched it. You won't receive notifications for entries already in the feed, only articles added after that.
Options and behavior
Feed to notification
| Entry | Notification |
|---|---|
| Source name, or the feed's title | Application |
| Entry title, if it has one | Event |
| Entry content, with HTML removed and cut off at about 2,000 characters | Description |
| Entry link, if it has one | URL |
Entries without a title, common on microblogs, arrive with only a description. The priority setting applies to every notification from the feed.
How often Prowl checks
Prowl tries to be a good citizen, so it follows nearly all of the recommendations from the Feed Reader Behavior Project. When several Prowl users follow the same feed URL, Prowl fetches it once and notifies everyone, so publishers see one reader instead of many.
Feeds that rarely publish new content are checked less often (up to daily), and those that publish often are checked more often (no more than hourly). Some publishers support a mechanism called WebSub; if the feed offers it, Prowl will deliver notifications as soon as new content is published.
Choose "Refresh" on the Source's page to check a feed immediately. You can trigger refresh this way at most once a minute.
New vs. updated
Prowl recognizes a new article by its ID, or its link if there is no ID. You won't receive a notification for updated entries, but if the feed's author doesn't have stable IDs or changes them, you may get notifications about content that isn't itself new.
Prowl skips any entry published more than 14 days ago, and collapses notifications when there are more than 5 new articles in a single check.
Troubleshooting
Prowl says my URL isn't a feed
If you entered a website's address and Prowl couldn't find a feed, you'll need to find one yourself. Look for a link labeled "Feed", "RSS", "Atom", or something with the feed icon.
If the site blocks Prowl, see My feed's website blocks Prowl.
My feed's website blocks Prowl
Sites sometimes block automated feed readers. This can show up as HTTP errors under "Last status" on the Source's page. A site owner can allow Prowl by either of the following:
IP addresses
Prowl loads feeds from the following IP addresses:
209.71.111.202a09:8280:e618:1:0:11f:5480:0
User-Agent
Prowl uses the User-Agent:
Prowl/<version> (+https://www.prowl.app/)
and sometimes adds other information into the comment part:
Prowl/<version> (+https://www.prowl.app/; <reason>)
| Reason | When |
|---|---|
probe |
A feed is added |
manual |
Any user chooses "Refresh" |
dormant |
A long-erroring feed is rechecked out of hope for its return |
websub |
A WebSub hub reports new articles |
Prowl couldn't fetch my feed
Prowl reads at most 1,000 entries from any feed. It only reads the first 4 MB of an RSS or Atom feed, and a JSON Feed larger than 4 MB can't be read at all. Prowl also gives up on a feed that takes longer than 12 seconds to respond. Very large feeds, such as podcasts with long histories, can hit these limits.
My feed stopped being checked
When Prowl encounters errors, it checks the feed less often. After a few days of errors it only checks weekly and sends you a "Feed checks slowed" notification, and after a few months of errors it stops checking and sends you a "Feed stopped" notification. If the provider tells Prowl that the feed has been permanently removed (HTTP 410), it stops right away.
Once the feed works again, you can bring a stopped feed back by choosing "Refresh" from the Source's page. You can also edit its URL to try a different one.
Disconnect or replace it
Change the URL
When you enter a new URL, Prowl will check that it works before switching the Source to it. Entries already at the new address don't notify, similar to setting up from scratch.
If the publisher moves the feed:
- For a temporary move, Prowl follows it and notes it on the Source's page, but keeps your URL.
- For a permanent move, Prowl updates the Source's URL to the new address and sends you a notification. If you already follow the new address with another Source, Prowl pauses this one instead and sends you a notification; you'll keep getting posts from the Source you already had.
Pause, resume, or remove
Pausing keeps your settings. If you're the only subscriber, Prowl also stops checking the feed; if other Prowl users follow the same feed, Prowl keeps checking it for them, but you won't get notifications. When you resume, entries published since the pause can trigger up to 5 new notifications.