Skip to main content
Logo
Explore APIsSupport Portal
  • Home
  • Match Preview
  • Tournament Preview
  • Virtual Stadium
  • StatsHub
  1. Engagement Tools
  2. Player Prop Zone

Player Prop Zone

Player Prop Zone widget displays player prop markets for a given match. It provides tabbed navigation by market type (goalscorers, cards, assists, shots, etc.) and supports custom tab order, label overrides, and bet slip integration via the onAction callback.

#What it looks like

The widget shows team selection at the top, primary prop categories (e.g. Goalscorers, Player goals, Player shots on goal), secondary filters (e.g. Anytime / 1st / Last goalscorer), and a pitch view with players and their odds. Locked or unavailable outcomes are indicated with a lock icon.

Player Prop Zone – Goalscorers (1st goalscorer) on pitch view

#Key capabilities

  • Tabbed markets: Navigate player prop markets by category (goalscorers, cards, passes, shots, tackles, etc.).
  • Configurable tabs: Restrict or reorder tabs via includedTabs, excludedTabs, and tabOrder.
  • Label overrides: Customize tab and secondary tab labels with labelOverrides.
  • Bet slip integration: Receive selection data via onAction and sync bet slip state via the adapter (see Bet slip integration).
  • Theming: Customize appearance via CSS classes (see Theming customization).

#Requirements

  • Match ID for the target match.
  • Adapter registered via SIR('registerAdapter', '{ADAPTER_NAME}'). For bet slip sync, the adapter must implement the betSlipSelection endpoint (see Bet slip integration).
  • See Adapter Overview for general adapter setup.

Environment Requirements

Technical Requirements:

  • JavaScript enabled
  • XMLHttpRequest support for data fetching
  • CSS3 support for styling and animations

#Available tab IDs

The widget uses market IDs (and for some types, outcome IDs or line keys) for tabs and secondary tabs. Use these IDs in includedTabs, excludedTabs, tabOrder, and labelOverrides.

#Single outcome market tabs

Secondary tab label keys are market IDs:

Expanded Table

Tab IDDescription
goalscorersGoalscorers (group: Anytime / First / Last)
playerToScorePlusTwoTo Score 2+
playerToScorePlusThreeTo Score 3+
playerToBeCardedLiveTo be carded (live)
playerToScoreFromOutsideOfTheBoxTo score outside the box
playerToScoreOrAssistTo score or assist
playerToBeSentOffTo be sent off

#Multiple outcome market tabs

Secondary tab label keys are outcome IDs:

Expanded Table

Tab IDDescription
playerToScoreIncludingOvertimePlayer to score
xthGoalscorerAndOneXTwoXth goalscorer & 1x2
anytimeGoalscorerAndOneXTwoAnytime goalscorer & 1x2
playerTotalShotsIncludingOvertimeTotal shots
playerTotalShotsOnGoalIncludingOvertimeTotal shots on goal

#Line market tabs

Secondary tab label keys are "increase" and "decrease":

Expanded Table

Tab IDDescription
playerGoalsIncludingOvertimeGoals
playerShotsOnGoalIncludingOvertimeShots on goal
playerShotsIncludingOvertimeShots
playerToBeCardedIncludingOvertimeTo be carded (prematch)
playerAssistsIncludingOvertimeAssists
playerPassesIncludingOvertimePasses
playerTacklesIncludingOvertimeTackles
playerXPlusShotsOnTargetX+ shots on target
playerXPlusShotsX+ shots
playerXPlusShotsOnTargetFromOutsideOfTheBoxX+ shots on target from outside the box
playerXPlusAssistsX+ assists

#API Reference

#Properties

Expanded Table

PropertyTypeDefaultDescription
matchIdstringRequiredThe match ID to get player prop markets for.
onActionfunctionundefinedCallback that receives bet slip data when a selection is clicked. Use for bet slip integration and analytics.
excludedTabsarray<string>undefinedMarket IDs to exclude from the navigation.
includedTabsarray<string>undefinedMarket IDs to include in the navigation. When set, only tabs matching these IDs are displayed. Takes precedence over excludedTabs.
tabOrderarray<string>undefinedOrdered list of market IDs defining custom sort order. Markets not in the list are placed at the end.
labelOverridesobjectundefinedOverride labels for specific tabs and their secondary tabs, keyed by tab ID. See structure below.

#labelOverrides structure

Each entry uses the tab ID as key and accepts:

  • label: Override the main tab label.
  • secondaryTabLabels: Override secondary (second row) tab labels. Keys depend on the market type:
    • Line tabs: keys "increase" and "decrease" (override the +/− line control labels).
    • Multiple outcome tabs: key is an outcome ID (each named outcome becomes a secondary tab).
    • Single outcome tabs: key is a market ID (each sub-market becomes a secondary tab).

Example:

json
{
  "goalscorers": {
    "label": "Goals",
    "secondaryTabLabels": {
      "40": "Any"
    }
  }
}

#Integration

#Basic setup

javascript
(function (a, b, c, d, e, f, g, h, i) {
  a[e] ||
    ((i = a[e] =
      function () {
        (a[e].q = a[e].q || []).push(arguments);
      }),
    (i.l = 1 * new Date()),
    (i.o = f),
    (g = b.createElement(c)),
    (h = b.getElementsByTagName(c)[0]),
    (g.async = 1),
    (g.src = d),
    g.setAttribute("n", e),
    h.parentNode.insertBefore(g, h));
})(
  window,
  document,
  "script",
  "https://widgets.sir.sportradar.com/sportradar/widgetloader",
  "SIR",
  {
    language: "en",
  },
);

SIR("registerAdapter", "{ADAPTER_NAME}");

SIR("addWidget", "#sr-widget", "match.playerPropZone", {
  matchId: "sr:match:61301097",
});
html
<div id="sr-widget"></div>

#With included tabs, tab order, and label overrides

javascript
SIR("addWidget", "#sr-widget", "match.playerPropZone", {
  matchId: "sr:match:61301097",
  includedTabs: ["goalscorers", "cards"],
  tabOrder: ["cards", "goalscorers"],
  labelOverrides: {
    goalscorers: {
      label: "Goals",
      secondaryTabLabels: {
        40: "Any",
      },
    },
  },
  onAction: function (data) {
    console.log(data);
  },
});
html
<div id="sr-widget"></div>

#Theming

For CSS customization (colors, borders, typography), see Player Prop Zone – Theming customization.

#Bet slip integration

To add selections to your bet slip and keep the widget in sync with bet slip state, see Player Prop Zone – Bet slip integration.

Last updated 23 days ago
Is this site helpful?
Widgets, Engagement Tools, BET
Swipe BetTheming
On this page
  • What it looks like
  • Key capabilities
  • Requirements
  • Available tab IDs
  • Single outcome market tabs
  • Multiple outcome market tabs
  • Line market tabs
  • API Reference
  • Properties
  • labelOverrides structure
  • Integration
  • Basic setup
  • With included tabs, tab order, and label overrides
  • Theming
  • Bet slip integration