Puzzled with filters in routes.yaml

In the Ghost tutorial Creating content hubs with Ghost, there is a full guide of the parameters for the filter property and inside this guide, these two lines are puzzling me:

filter: tag:x,tag:y # can have either "x" or "y" tags (, = OR)
filter: tag:[x,y,z] # must have either "x", "y", or "z" tags ([] = IN)

For the life of me, I cannot fathom the difference between “can have either” and “must have either”. Furthermore, both filters are displaying a different set of posts when used in my channel definition in routes.yaml, but that’s for another forum topic, and maybe a pharmacy :smile:
Is there a kind soul out there that could help me understand the difference between those two filter options, OR and IN?


From the example, OR and IN should behave the same. The main difference is OR can be used for multiple things (e.g. tag:x,author:jdoe), while IN only operates on the one thing (e.g. only tags, or only authors).

You should be getting the same result set when using tag:x,tag:y and tag:[x,y] :slight_smile:

Thank you for your time and effort @vikaspotluri123