Filtering articles


When the number of articles stored by FreshRSS inevitably grows larger, it’s important to use efficient filters to display only a subset of the articles. There are several methods that filter with different criteria. Usually those methods can be combined.

By category

This is the easiest method. You only need to click on the category title in the side panel. There are two special categories at the top of the panel:

By feed

There are several methods to filter articles by feed:

Feed filter

By status

Each article has two attributes that can be combined. The first attribute indicates whether or not the article has been read. The second attribute indicates if the article was marked as favorite or not.

In version 0.7, attribute filters are available in the article display dropdown list. With this version, it’s not possible to combine filters. For instance, it’s not possible to display only read and favorite articles.

Attribute filters in 0.7

Starting with version 0.8, all attribute filters are visible as toggle icons. They can be combined. As any combination is possible, some have the same result. For instance, the result for all filters selected is the same as no filter selected.

Attribute filters in 0.8

By default, this filter displays only unread articles

By content

It is possible to filter articles by their content by inputting a string in the search field.

With the search field

You can use the search field to further refine results:

Be careful not to enter a space between the operator and the search value.

Some operators can be used negatively, to exclude articles, with the same syntax as above, but prefixed by a ! or -: !f:234, -author:name, -intitle:keyword, -inurl:keyword, -#tag, !keyword, !date:2019, !date:P1W, !pubdate:P3d/.

It is also possible to combine keywords to create a more precise filter. For example, you can enter multiple instances of f:, author:, intitle:, inurl:, #, and free-text.

Combining several search criteria implies a logical and, but the keyword ` OR ` can be used to combine several search criteria with a logical or instead: author:Dupont OR author:Dupond

You don’t have to do anything special to combine multiple negative operators. Writing !intitle:'thing1' !intitle:'thing2' implies AND, see above. For more pointers on how AND and OR interact with negation, see this GitHub comment. Additional reading: De Morgan’s laws.

Finally, parentheses may be used to express more complex queries, with basic negation support:

ℹ️ If you need to search for a parenthesis, it needs to be escaped like \( or \)

By sorting by date

You can change the sort order by clicking the toggle button available in the header.

Store your filters

Once you came up with your perfect filter, it would be a shame if you need to recreate it every time you need to use it.

Hopefully, there is a way to bookmark them for later use. We call them user queries. You can create as many as you want, the only limit is how they will be displayed on your screen.

Bookmark the current query

Display the user queries drop-down by clicking the button next to the state buttons. User queries drop-down

Then click on the bookmark action.

Congratulations, you’re done!

Using a bookmarked query

Display the user queries drop-down by clicking the button next to the state buttons. User queries drop-down

Then click on the bookmarked query, the previously stored query will be applied.

Note that only the query is stored, not the articles. The results you are seeing now could be different from the results on the day you’ve created the query.

Read more: