GuidesAPI ReferenceRelease Notes
HomeLog InHome
Guides

Labels and scheduling

Labels are category tags that define the subject of a content item. They determine which content the backend serves to the Experiences SDK and influence how content is filtered and prioritized across digital experiences.

Labels function as filters, controlling which content is available to digital properties.

Related reading: Free text context search methods

An asset is eligible to be served only when all of the following are true:

  • The asset indicator is Active. You can set activation status (Draft / Active) manually, or automatically by game event, fixed time, or delay. See Automatic event-based activation.
  • The asset has a defined schedule, and the current time falls within its schedule window.
  • The SDK requested a set of given labels.
flowchart LR
  A[Request to serve item] --> B{Asset is active?}
  B -- No --> X[Not served]
  B -- Yes --> C{Schedule defined?}
  C -- No --> X
  C -- Yes --> D{Current time in schedule window?}
  D -- No --> X
  D -- Yes --> S[Serve item]

Label principles

  • Labels are alphanumeric strings used to categorize content. There are no restrictions on label structure or naming.
  • A content item can have zero, one, or multiple labels.
  • Labels can be applied in the following ways:
    • Automatically by Rules, using static labels or dynamically generated labels based on game and play metadata.
    • Manually during the Create or Clipro publication process.
    • Manually added or removed in CMS after content creation.
  • Labels typically map to content metadata such as teams, leagues, tournaments, and players. They can also represent actions, scores, sponsors, or other custom attributes.
  • Labels are the foundation for filtering, prioritizing, and tailoring content in the app.
  • Ask your WSC Sports engineer for help defining a consistent label naming strategy.

How labels are used

Labels help the app surface content that aligns with viewer interests and selected entities, enabling experiences such as feeds tailored to viewer interests.

When a viewer selects favorite teams or leagues, the app maps those selections to labels and passes them to the SDK using BlazeDataSourceType (iOS | Android). The SDK then filters content in widgets and entry points and can optionally prioritize content based on the provided labels.

Labels dashboard

Labels are managed in the CMS Labels dashboard. The dashboard displays all labels in the system along with the content items associated with each label and their current activation status.

Labels dashboard tour

  1. In CMS, go to the Labels tab.
    The list of labels appears.

  2. From this view, you can:

    • Apply filters to locate specific labels.
    • Add a new label by selecting Add New Label.
    • Select a label to view the content items associated with it.

Label drill-down view

The label drill-down view shows content items associated with the selected label and supports the following filters:

  • All: All associated content items.
  • Published: Content whose schedule window includes the current time. Items may appear here even if the asset indicator is not Active, but only Active assets can be served.
  • Scheduled: Content with a schedule window set for a future time.
  • Unscheduled: Content with no schedule window.

This view helps distinguish between content that is visible in CMS and content that is eligible to be served.

When you select a content item to display the Preview panel


Did this page help you?