Skip to main content
ScoreBird

Virtual Scoreboard Embed

Virtual Scoreboard Embed

Embed a live virtual scoreboard on any website. The widget displays the current game with real-time score, clock, and period updates — no page refresh required.

The widget has two view states that switch automatically:

  • Upcoming Game View — shown before a game starts, displays the next scheduled game
  • Game Final View — shown after a game ends, displays the final score

For more information about virtual scoreboards, see the Virtual Scoreboards feature page.

Requirements

  • A ScoreBird account with an active NeST device or ScoreBuddy Pro subscription
  • Your widget parameters from the ScoreBird Portal

JavaScript Method (Preferred)

The JavaScript method is the recommended approach. It avoids the iframe sizing and responsive layout issues that are common with the iframe method.

<div id="scorebird_sg_widget"></div>
<script type="text/javascript">
  window.addEventListener('load', function () {
    ScorebirdWidgetV2.init({
      selector: "scorebird_sg_widget",
      primaryColor: "",
      secondaryColor: "",
      serial: "",
      team_id: "",
      schedule_id: "",
      sport: ""
    });
  });
</script>
<script type="text/javascript" src="https://widget.scorebird.com/scorebird-widget-v2.min.js" async></script>

iFrame Method (Alternative)

Use the iframe method if you cannot add JavaScript to your page (e.g., some website builders).

<iframe
  style="border: 0px;"
  frameborder="0"
  width="510"
  height="500"
  src="https://widget.scorebird.com/single-game-widget?sport=&serial=&primary_color=&secondary_color=&team_id=&schedule_id=">
</iframe>

Parameters Reference

ParameterRequiredDescription
selectorYesThe id of the <div> element where the widget renders
serialOne of three requiredNeST device serial number
team_idOne of three requiredScoreBird team identifier
schedule_idOne of three requiredScoreBird schedule identifier
primaryColorNoPrimary brand color (hex, e.g. #003087)
secondaryColorNoSecondary brand color (hex, e.g. #FFB81C)
sportNoSport type (e.g. basketball, football)
swap_home_awayNoSwap home and away team positions (true/false)

Wrestling-Specific Parameters

ParameterDescription
show_adv_time_diff_timerShow advantage time difference timer
show_adv_team_timerShow per-team advantage timer
show_blood_timerShow blood time timer

At least one of serial, team_id, or schedule_id is required. Obtain these values from your ScoreBird Portal.

Troubleshooting

  • Widget not showing? Verify the id on your <div> matches the selector parameter exactly.
  • Score not updating? Ensure a game is active and your NeST device is online.
  • Widget not sized correctly? Switch to the JavaScript method — it handles responsive layouts better than the iframe method.
  • Need help? Contact support at support@scorebird.com or call 844-GOT-BIRD (844-468-2473).

Still need help?

Can't find what you're looking for? Our support team is here to help.

Contact Support →

Ready to automate your scores?

NeST connects to your scoreboard and powers everything you just read about.