Using list rules

This article explain how list rules work, and how to set them up to drive dynamic lists.

Topics covered:

• What are list rules?
• How to set up a list rule
• Reordering list-driven rules
• Combining rules and assets
• Duplicate assets in a list
• Saving and publishing lists

What are list rules?

List rules allow you to apply logic to the surfacing of content on your lists. They keep the list content dynamic, automatically updating it based on the ruleset criteria. Using basic rules, you can eliminate manual curation and ensure viewers are always served up-to-date content. 

For example, let's take a list: Movies (Latest). With list rules, newly-ingested movie content can be automatically added to the list and sorted based on availability or offer date, then made available to users with the appropriate subscription tier. All without the need for the movie assets to be manually selected from the catalog and added to the list.

Another use case involves combining list rules with asset relations, to dynamically add new content to your lists based on predefined associations between asset types.

For example, where an asset relation has been defined between team and competition, use list rules to surface related competition assets associated with a team, as and when they're added.

How to set up a list rule

When curating a list, at the bottom of the page you'll notice the option to Add an asset OR Add Rules.

1. Select the Add Rules link to display rule fields
2. Start by selecting the asset type(s) that will be used to build your list - for example, movie or event
3. Next, use the fields that follow to specify the additional parameters that will drive your list rule. For a movie, this could be genre or category, for instance, whereas a sport event list rule might be driven by competition.
4. You can select additional criteria to build up your ruleset - simply click into the Please choose... field on a new line - until you're satisfied that you've included all relevant content parameters
5. Use the Sort dropdown to define the order in which the assets should appear on the list
6. Finally, specify the maximum number of assets the list should contain. The Max. items dropdown also gives you the option of setting this to unlimited

Below is an example of a list rule set to update the list Movies (Latest) with all new Movie assets released After 2020, sorted by Date offered (newest first) with a Max. items set to 25.

In this case, the list will automatically update with new movie assets that were released after 2020, with the most recently-offered appearing at the beginning of the list.

Another example below shows how you would use the Has relation list filter, combined with the Followed items selection, to add a list rule that automatically populates the list with all events involving any team the user follows.

Use metadata and tagging, and the offer-ability/scheduling window of assets (content) to create rule-driven lists.

For example, create a list displaying episodes (asset type) for a specific channel (tag) that are expiring in (offer) 7 days. If you're offering a catchup service, this means episodes can be continuously added and removed from the catalog.

How do I reorder rule-driven lists?

If you wish to change the assets' positioning within a rule-driven list (to overwrite the automatic order), simply find the asset in the list and drag it into position.

Note that if you manually edit a list that's already in use, when you save it, any Reference App row currently using the published list is automatically updated.

Can I combine rules and assets?

Yes, rules and assets can be combined to ensure prominent assets are showcased by being added manually. The list can then be backfilled with related content using rules.

See our creating and managing lists article for more information on how to manually select and add assets to your lists.

Duplicate assets in a list

By default, Presentation Manager automatically removes duplicate assets from lists - for example in cases where an asset is automatically inserted through a list rule, but also added manually.

In terms of positioning, the asset higher up the list will be kept in preference to the duplicate further down.

Saving and publishing lists

By clicking the button, the list is made visible to your end users to view and interact with.

Need to make additional changes before going live?

No problem, save your list without publishing by selecting the More button, followed by Save. This action saves your changes but the list remains in a draft state until it's manually published.

Alternatively, from the More menu, you have the option to Archive or Delete the list.

 

---

Related articles:

• Lists
• Creating and managing lists
• Asset relations
• Following assets