Learn how to surface related content here.*
This article covers asset relations - how they're applied to assets and how they can be used to drive list rules.
Topics covered here:
- What are asset relations?
- An asset relations use case
- How to add a related asset
- How to remove a related asset
Are you an Administrator looking to set up asset relations so they can be added to your assets? Read our separate article on how to create and manage asset relations.
What are asset relations?
Asset relations create a connection between different asset types - for example, between movie and persona asset types, or between competition and event - that you can apply to your assets to drive dynamic relationships, and configure on a per-project basis. Asset relations work hand-in-hand with list rules to surface related content to users in their apps.
Before it can be applied, an asset relation must first be defined by an Administrator. The Asset Relations page (Admin → Settings → Asset Relations) is where asset relations are created and where the asset types they apply to are specified.
Here, configured asset relations are displayed using asset icons. In the image below you can see the relation display name on the left-hand side of the screen. On the right-hand side, the source asset type(s) (relationship from) are listed to the left of the arrow icon, with the related asset type (relationship to) on the right.
Taking the first row as an example, the asset relation with the display name Teams has persona, competition, confederation, event, program, and stage asset types all being related to the team asset type. This creates a connection between team assets and those other asset types, which can then be used to drive other activity, as explained below.
An asset relations use case
A possible use case would be to display related Event assets in a row on a Team or Persona detail page.
Using the Teams asset relation described above, and the association it creates between the event (source) asset and the team (related) asset, you could add a list rule to a row on the Team detail page that automatically displays all events related to that team.
You can make further use of asset relations in list rules by using them to filter how related assets display within rows - for example, defining the ordering of assets or sorting on the asset status (e.g., live or upcoming).
Find out more about setting up a sport or entertainment detail page.
How to add a related asset:
Related assets are added and viewed in an asset's Related tab: Asset → Items → Related.
Only asset types with an existing relation to the selected asset (i.e. already defined by an Administrator, as explained above) can be added here.
- Select the tab (asset relation display name) you require. The icon(s) to the right of the Add an asset field indicates which asset types can be added. In the example above, only Program assets can be added to the Clips tab.
- Enter a search term to view matching assets of the relevant type.
- Select the appropriate asset and click the button.
- To complete the process, navigate to the related asset that you've just added, and save and update that as well.
- The related assets can now be used in a list rule.
Important: The assets on both sides of the relationship must be saved before the asset relation takes effect. To complete setup, don't forget to go into the other asset and save that as well.
How to remove a related asset:
- Select the required relation tab.
- Hover over a related asset and select the icon. The asset relation is removed.
- Select the button to save changes.
Important: To complete the removal process, and to avoid any issues for your users, you must repeat the removal process on the related asset (in this example Serena Williams), then save and update.