Content Lists
=============

What playlists are to music, content lists are to articles - customizable sets of content organized and ordered in the way that suits your output channel best. For example, when you access a Publisher website homepage as a visitor, chances are that the teasers for articles you see are curated by website editors using *Content lists*. The order of articles can be easily updated as news arrives, new articles are added, some others removed etc.

Manual Content Lists
--------------------

With *manual content lists*, articles need to be drag-and-dropped into the list manually. This gives complete freedom to editors to put which stories where. A list can be (and should be) limited in length, so when a new article is added on top, the last one drops out.

Automatic Content Lists
-----------------------

If a list doesn't need to be fully customizable, or if it can be programmed with certain rules to collect appropriate articles, then the *automatic content list* steps in. 

For example, a block on the webiste shows the most recent articles from the Sport section, where the metadata location is set to 'Europe' and author is not John Smith; in this situation, obviously editors don't need to put in manual labour, but can rather use an automated set of rules to add articles to the automatic list.

Built in criteria:

- ``route`` - an array of route ids, e.g. [1,5]

- ``author`` - an array of authors, e.g. ["Test Persona","Doe"]

- ``publishedBefore`` - date string, articles published before this date will be added to the list,
e.g. date: "2021-01-20". (date format must be YYYY-MM-DD)

- ``publishedAfter`` - date string, articles published after that date will be added to the list, format is the same as in the ``publishedBefore`` case.

- ``publishedAt`` - date string, when defined articles matching this publish date are added to the list when published, the format is the same as in case of ``publishedBefore`` and ``publishedAfter``

- ``metadata`` - metadata is the dropdown field where filtering can be done by any of an article's metadata: Categories, Genre, Urgency, Priority, Keywords, and any custom vocabulary that is set as a field in a content profile in Superdesk

All criteria can be combined together with that the result it will add articles to the list (on publish) depending on your needs.