Skip to content

Channel

The channel configuration block defines your feed metadata.

This example is a complete feed config so you can see the channel block in context:

channel:
url: https://example.com
title: "My Custom Feed"
description: "A feed of the latest news from Example.com"
author: "jane.doe@example.com (Jane Doe)"
ttl: 60
language: "en"
time_zone: "Europe/Berlin"
selectors:
items:
selector: "article"
title:
selector: "h2"
url:
selector: "a"
extractor: "href"
AttributeRequiredDescription
urlRequiredThe URL of the website to scrape.
titleOptionalThe title of the RSS feed. Defaults to the website’s title.
descriptionOptionalA description for the RSS feed. Defaults to the website’s meta description.
authorOptionalThe author of the feed, in the format email (Name).
ttlOptionalThe “time to live” for the feed in minutes. Defaults to the max-age from the response headers, or 360.
languageOptionalThe language of the feed. Defaults to the lang attribute of the <html> tag.
time_zoneOptionalThe time zone for parsing dates. See the list of tz database time zones.
  • language is runtime-validated. Use a valid language code such as en, not an arbitrary string.
  • author should follow the RSS-style email (Name) format when you set it explicitly.
  • time_zone must be a known TZ database identifier such as UTC or Europe/Berlin.

For detailed documentation on the Ruby API, see the official YARD documentation.