In readflow you can split your reading flows into categories. Adding an article to a category will be based on the rules you have configured.


To manage categories, go to the configuration screen:

You can add a category by clicking on Add category button.

A category is a simple title and assignment rule.


When adding an article, the rule engine will be activated and apply the rules ordered by categories. At the first validated rule, the article is placed in the target category. If no rules match then the article will not have a category.

The definition of a rule is a pseudo code whose result must be true or false.

Within the rule it is possible to refer to some attributes:

  • title: article title
  • text: article text content
  • url: article source URL
  • tags: article input tags
  • webhook: incoming webhook alias



  • == (equal)
  • != (non equal)
  • matches (validate a regular expression)
  • not ("foo" matches "bar") (does not validate a regular expression)

Logical operators

  • not or !
  • and or &&
  • or or ||

Other operators

  • ~ (concatenation) Example: 'Harry' ~ ' ' ~ 'Potter' will be Harry Potter
  • in
  • not in Example: webhook in ["test", "bookmarklet"]


  • len (length of the character string) Example: len(text) >= 100


Classify articles whose incoming webhook alias is “foo”:

webhook == "foo"

Classify articles with incoming webhook alias is “foo” or “bar”:

webhook == "foo" || webhook == "bar"
// Can also be written:
webhook in ["foo", "bar"]

Classify articles with “foo” as tag:

"foo" in tags

Classify articles with titles containing “Amazon” and “Alexa”:

title matches "Amazon" and title matches "Alexa"

Classify items that come from CNN:

url matches "^"