Entities

​

Introduction

An entity in Motto’s systems represents any organization, person or thing. Entities are useful in several ways:

• They can be associated with events, and help give structure to your content. E.g. associating a competition entity with a football event.
• They can be used to build up a hierarchy or taxonomy of related entities. E.g. associating a competition entity with a league or organizing body.
• You can sell subscriptions based on entity access. E.g. selling a subscription to every event in a competition.

The points above become important when you want an end user of your OTT platform to be able to navigate your content structure easily. For example, if they are watching a football match, you might want to suggest similar matches from that same competition.

With Motto’s powerful entity system, all of this (and more) is possible.

​

Heads up

Before diving into entities, you must first create an entity type. This is the blueprint that defines what an entity can look like. For example, if you want to make entities for clubs like FC Barcelona and Real Madrid, you should first create the entity type club (or similar, the naming and structure are in your own hands)!

​

Get Started

Once you have created your entity type as hinted at above, you can get started using the Motto Studio, which we recommend for non-technical users. Alternatively, you may get started by using the Motto API.

Via the Studio

The following steps will guide you through the process of setting up an event via the Studio.

Creating an entity

First, navigate to the “Library” tab in the Studio. You will see a list of available entity types like in the image below.

If you do not see any entity types like above, you must first create a content type.

Click on the “New” button to start creating a new entity. A sidebar will appear that prompts you to enter the entity’s details. The details that you can fill out here are fully flexible! It depends entirely on your own requirements.

After pressing “Save”, your entity is now created and will show up in the list of entities.

Via the API

If you prefer using the Studio API to interact with the Motto platform, you can follow the following steps to achieve the same result as described in the “Via the Studio” section.

1. Call the Create Entity endpoint.

For the endpoint above, you will need a type_id. This is the identifier of your custom type, which you must first create a content type.

That’s it!