Help

Subscribing to feeds

Finding a site's feed

If you don't know a feed's URL, enter the website's address instead. We'll find any feeds it offers and let you choose from a list.

How often updates arrive

Blogtrottr provides a variety of schedules for you to choose from:

  • As soon as possible - every update gets its own email.
    • Free and No Ads plan - within seconds for WebSub enabled feeds, or we poll every hour for other feeds.
    • Lite and Full plans - within seconds via WebSub, or our Advanced Polling for other feeds.
  • 2/4/6/8/12 hourly or daily digests - multiple updates are rolled into a single email.

Some feeds define a TTL (time to live) value, which tells subscribers the minimum interval between checks. If a feed sets a TTL that is longer than our default polling interval, we'll honour it.

WebSub (instant updates)

If your feeds support WebSub (previously known as PubSubHubbub or PuSH), then you can expect to get an update within a couple minutes of a new item being posted. Typically email leaves our systems within a few seconds of us being notified - although the internet being what it is, the email may take a bit longer to find its way across the world and into your inbox.

WebSub is a protocol that allows interested parties to be notified almost immediately when new content is added to a feed, rather than having to wait for a periodic check.

Feeds that need a login

If the feed uses basic HTTP authentication, you can put a username and password into the URL like this: http(s)://username:[email protected]/feedname.xml
This means of course that we'll have these credentials stored in plain text, and while we won't reveal them to anyone it'd be a sensible precaution to use a unique password, and not one that you use on other sites or services.

Email subject tags

When editing a subscription, you have the option of adding static text or tags to the email subject.

All dates and times are based on your user account timezone setting.

TagDescription
{feed_title} The title of the current feed
{item_title} The title of the current item
{schedule_name} The name of the selected schedule - e.g. 'Daily digest'
{subscription_category} The name of the subscription's or digest's category, or blank if it has none
{item_count} The number of items in the email. Always 1 for subscriptions sent 'As soon as possible'
{digest_preview} The titles of the items in the email, separated by | and shortened to about 90 characters
{digest_preview_N} As above, but shortened to about N characters instead, where N is a number from 10 to 999. e.g. {digest_preview_50}
{date_d-m-y} The current date, in day-month-year format, with leading zeros and a 4 digit year. e.g. 05-12-2012
{date_m-d-y} The current date, in month-day-year format, with leading zeros and a 4 digit year. e.g. 12-05-2012
{date_y-m-d} The current date, in year-month-day format, with leading zeros and a 4 digit year. e.g. 2012-12-05
{time_h:i:s} The current time, in 24 hour format. e.g. 14:12:32

Digest names

A digest's name is used in place of {feed_title} in its subject and sender fields, and as its name in your subscriptions list.

Getting updates as attachments

On Lite and Full plans, you can have updates sent as a file attached to the email, rather than in the email itself. Choose one from the Output setting when creating or editing a subscription or digest:

  • PDF - a formatted document with each item's content and images. Handy for printing, or reading on an e-reader.
  • Simple HTML - a lightweight web page you can open in any browser or save for later.
  • Text - plain text with no formatting or images, useful for archiving or passing on to other tools.

Each email has a single attachment, named after the feed, containing every item in that delivery. If an attachment makes the email too large to send, we'll email you a download link instead, which works for 48 hours.

Custom email templates

On Lite and Full plans, you can design your own layout for update emails. On your Account Settings page, tick Custom email template and edit the three blocks: a header shown once at the top of each email, an item block repeated for every item, and a footer at the bottom. A custom template replaces the Template setting, and only applies to emails, not attachments or webhooks.

Each block lists the tags it supports, such as {feed_title}, {item_title}, {item_body}, {item_datetime} and {media_links}. The footer must include {unsubscribe_link}.

To go back to the original layout, use the Reset to default button in a block's toolbar, then save.

Unsubscribing from a feed

At the bottom of any update email you get should be an unsubscribe link - you can click that to remove a particular subscription.

Or, you can signup for an account using the email address you used previously, and then you can manage all your existing subscriptions through your web browser.

Alternatively, if your email client supports it, you can one-click unsubscribe.

Dead or broken feeds

If a URL hasn't returned any valid feed data (e.g it's returning a 404 error, a domain holding page, or something else that isn't a feed) for more than 6 months, we'll consider it dead and remove subscriptions to it from our system.

Categories

Categories let you organise your subscriptions into named groups, and optionally apply a shared filter across all subscriptions in that group.

What are categories?

A category is a label you create (e.g. "Tech news" or "Work") that you can assign to one or more subscriptions. Once assigned, you can filter your subscription list by category to quickly find related subscriptions, and bulk-assign new subscriptions to a category in one step.

To manage your categories, go to Categories in the navigation menu.

You can include the category name with the {subscription_category} tag in email subjects, in custom email templates (set up on your Account Settings page), and in Form encoded and Raw webhooks.

Category filters

Each category can have an optional default filter. When a subscription belongs to a category and has no filter of its own, it automatically uses the category's filter to decide which items to deliver.

This makes it easy to apply the same filtering logic to a whole group of subscriptions without configuring each one individually. For example, you could create a "Python news" category with a filter that only sends items containing "Python" in the title, then assign any relevant feeds to it.

If you later want a particular subscription to behave differently, you can enable a filter on that subscription directly. A subscription's own filter always takes precedence over the category filter. When viewing or editing a subscription that is inheriting its category's filter, you'll see a notice explaining this.

Managing categories

From the Categories page you can:

  • Create a new category, with or without a default filter.
  • See how many subscriptions belong to each category.
  • Edit a category's name or filter at any time.
  • Delete a category (subscriptions in it simply become uncategorised).

You can assign a subscription to a category when creating or editing it, or select multiple subscriptions on the subscriptions page and use the Category... dropdown to bulk-assign them.

Filters

Filters let you control which feed items you receive, based on their content. You can set up filters when creating or editing a subscription.

What are filters?

A busy feed might publish dozens of items a day, but you may only care about certain topics or authors. Filters let you automatically include or exclude items based on their title, body, URL, author, or category - so you only get the updates that matter to you.

To get started, tick the Filter enabled checkbox when creating or editing a subscription.

Filter example

Filter rules

A rule is a single condition that checks part of a feed item. Each rule has three parts:

  • Field - which part of the item to check:
    • Title - the item's headline
    • Body - the main content of the item
    • URL - the link to the item
    • Author - who wrote the item
    • Category - the categories or tags assigned to the item
  • Condition - how to check it:
    • contains - matches if your search term appears anywhere in the field (not case-sensitive)
    • doesn't contain - matches if your search term does not appear in the field
  • Value - the text to search for

Filter groups

Rules are organised into groups. When a group has more than one rule, you choose whether an item must match all of the rules or just any one of them.

If you have more than one group, you also choose whether the item must match all of the groups or just any of them. This gives you a lot of flexibility to express exactly what you want.

For most people, a single group with one or two rules is all you need. Add more groups when you want to combine conditions in different ways.

Send me vs Ignore filters

At the top of the filter you'll see a dropdown with two choices:

  • Send me - you'll only receive items that match your rules. Everything else is ignored.
  • Ignore - items that match your rules are discarded. You'll receive everything else.

Advanced filters: pattern matching

For more powerful matching, you can use matches regex and doesn't match regex instead of the simple contains/doesn't contain conditions.

A regular expression (regex) is a special pattern that can match text in flexible ways. Here are some useful examples:

PatternWhat it does
python|django Matches "python" or "django"
^Breaking: Matches only if the text starts with "Breaking:"
sale$ Matches only if the text ends with "sale"
v\d+\.\d+ Matches version numbers like "v2.0" or "v12.34"

Regex matching is not case-sensitive. If you're not familiar with regular expressions, the contains and doesn't contain conditions will cover most use cases.

Filter examples

Only get posts about a specific topic

Set the action to Send me, and add one rule: title contains Laravel. You'll only receive items with "Laravel" in the title.

Hide posts from a particular author

Set the action to Ignore, and add one rule: author contains Guest Author. Posts by that author will be filtered out.

Only get posts about Python or Django

Set the action to Send me, and create a group with two rules using match any:

  • title contains Python
  • title contains Django

You'll receive items that mention either term.

Get posts about Python, but not beginner tutorials

Set the action to Send me, and create a group with two rules using match all:

  • title contains Python
  • title doesn't contain beginner

You'll receive items that mention Python but not those aimed at beginners.

Webhooks

Webhooks are available on Lite and Full plans. Instead of delivering feed updates by email, you can point a subscription at any HTTP endpoint - Blogtrottr will POST new items to your URL as they arrive. Custom HTTP headers are also supported, to enable passing authentication tokens or other metadata to your endpoint.

For details on delivery behaviour, retries, and the User-Agent we send, see our webhook delivery robot page.

Webhook JSON format

When using the JSON webhook type, we send a POST request with a application/json content type and the following structure:

{
  "feed": {
    "title": "Example Feed",
    "description": "A description of the feed",
    "url": "https://example.com/feed.xml"
  },
  "subscription_id": "abc123",
  "items": [
    {
      "title": "Post Title",
      "link": "https://example.com/post",
      "body": "<p>The full post content</p>",
      "date": "2026-01-15T12:00:00+00:00",
      "authors": ["Author Name"],
      "categories": ["Category"],
      "thumbnail": "https://example.com/thumb.jpg"
    }
  ]
}

If a lot of new items arrive at once, they may be split across several requests, each in this same format.

If you need a custom body format, choose the Form encoded or Raw webhook type instead.

Webhook form encoded format

When using the Form encoded webhook type, we send one POST request per feed item with a application/x-www-form-urlencoded content type.

You provide a body template using placeholder tags. All tag values are automatically URL-encoded. For example:

title={item_title}&url={item_link}&feed={feed_title}

Available tags: {feed_title}, {feed_description}, {feed_url}, {item_title}, {item_link}, {item_body}, {item_date}, {subscription_category}

Webhook raw format

When using the Raw webhook type, we send one POST request per feed item with a text/plain content type.

You provide a body template using placeholder tags. No escaping is applied - tag values are inserted as-is. For example:

New post: {item_title}
Link: {item_link}
Feed: {feed_title}

Available tags: {feed_title}, {feed_description}, {feed_url}, {item_title}, {item_link}, {item_body}, {item_date}, {subscription_category}

Your account

Changing your email

Go to your Account Settings page and click Change next to your email address. Enter your new address and click Send verification link, and we'll email a verification link to it. Follow that link and click Confirm change to finish. Your email address won't change until you do.

Two-factor authentication

Two-factor authentication (2FA) adds a second step when you log in. As well as your password, you'll need a short code from an authenticator app such as Google Authenticator, 1Password or Authy. Even if someone learns your password, they can't get into your account without that code.

Go to Account › Two-factor authentication and click Enable. After confirming your password you'll see a QR code - scan it with your authenticator app, or type in the setup key shown underneath. Then enter the code your app generates and click Confirm. 2FA isn't active until you've completed this last step.

2FA recovery codes

Once 2FA is on, click Show recovery codes to see a set of backup codes. Store them somewhere safe, like a password manager. If you ever lose access to your authenticator app, click Use a recovery code on the login screen and enter one of these instead.

Each recovery code only works once. If you think someone else may have seen your codes, click Regenerate recovery codes to replace the whole set - the old codes will stop working straight away.

Turning off 2FA

Click Disable on the Two-factor authentication page. You'll be asked to confirm your password first.

Additional email addresses

Available on Lite and Full plans. Add up to 25 verified delivery addresses to your account, so different subscriptions can send to different inboxes - without needing separate Blogtrottr accounts.

What are additional email addresses?

By default, all your feed updates are delivered to your main account email address. With additional email addresses, you can route individual subscriptions to any other address you've verified - a work inbox, a personal inbox, a dedicated filtering address, and so on.

Adding an additional email address

Go to Account › Email addresses and enter the address in the field provided. We'll send a verification link to that address - click it to confirm ownership, and the address will become available to use on your subscriptions.

Sending a subscription to an additional address

When creating or editing a subscription, select one of your confirmed addresses from the Delivery address dropdown. If no additional address is selected, updates are sent to your main account email as normal.

Removing an additional email address

Click Remove next to an address on the Email addresses page. Any subscriptions that were using it will automatically revert to your main account email address.

Importing and exporting

Importing subscriptions

On the Import page you can upload either an OPML file, which most feed readers can export, or a plain text file with one feed URL per line. Files can be up to 4MB, and you choose a schedule for the imported feeds before uploading.

Imports run in the background, and we'll email you a summary when it's finished, including any feeds that couldn't be added. Some feeds that are temporarily unreachable are retried automatically later on.

Feeds you're already subscribed to on the same schedule won't be duplicated, and lines that aren't valid URLs are ignored. If an import takes you over your plan's subscription limit, the extra subscriptions are paused, starting with the most recently added.

Exporting subscriptions

On the Export page you can download your subscriptions as OPML, for use in feed readers, or as CSV for spreadsheets.

OPML exports can optionally include extended attributes, such as each subscription's schedule, filters and email subject. These are read back in if you import the file into Blogtrottr later, which makes it a handy way to back up your settings.

If you have more than 250 subscriptions, we'll prepare the export in the background and email you a download link, which works for 48 hours.

API

Blogtrottr provides a REST API for managing your subscriptions programmatically. See the full API documentation.

General

Autoblogging

Autoblogging is the practice of automatically posting content (usually copied without permission from other sites) to blogs or websites. Due to complaints from content owners about their work being republished, any user accounts detected using Blogtrottr for this purpose will be automatically suspended.

There are many services and software packages out there dedicated to autoblogging; if you still feel that you must do this, please go and use one of them instead.

Blogtrottr's feed robot

Curious about how our feed-fetching robot behaves - conditional requests, WebSub, TTL handling, and request signing? Read more on our robot page.

Company details

Blogtrottr Ltd is a registered UK company, 08447594.

Registered office (please send all technical and support queries to [email protected]):

Blogtrottr Ltd
71-75 Shelton Street
Covent Garden
London
WC2H 9JQ

Cookies

You can read more about the cookies we use on our cookies policy page.

Getting in touch

We're always interested in hearing what people think. You can email us at [email protected]

Privacy & email

You can find full details of our privacy policy on our Policies, Terms and Conditions page.