How to add a leaderboard or scoreboard widget to WordPress

Get our plugin to make adding a leaderboard, goal tracker or score widget to your WordPress site a matter of seconds.

Do you want to add a widget with a leaderboard or scoresheet to your WordPress site? We have a plugin that makes this dead easy.

Note that you require a paid PRO plan to use this feature.

Once you have added the widget to your post, the scores update automatically: if you add new scores or players, your post will get updated in real-time!

This leaderboard has been embedded into a WordPress post using KeepTheScore

How it works

There are 3 steps to embedding a widget in a WordPress post:

  1. Install the KeepTheScore plugin.
  2. Create a board on and get its shortcode.
  3. Add the shortcode to your post.

You're done ✨

Let's go through these steps in more detail.

1. Install the WordPress plugin

This is something you do once only. After you have done it, you can add as many boards to as many posts as you like.

  1. Go to your WordPress site and login
  2. Go to plugins, Add new
  3. Search for "keep the score" and click the correct search result
  4. Click on Install now
  5. Click on Activate plugin

Alternatively you can download the plugin from the offical WordPress plugin directory by clicking here. You can then upload the plugin as shown below:

Example of an embedded scoreboard

Please consider leaving a review for the plugin.

2. Create a board and get its shortcode

Next you need to choose the type of widget you want to create. Look at this page for examples and explanations of all the tools on offer.

💡 NOTE: you can embed all board types except for live sports scoreboards. These can be embedded too, but require the use of an iframe.

Once you have made your choice, follow these steps to create a board and get its shortcode:

  1. Create a scoreboard or leaderboard by clicking here .
  2. Click on the "PUBLISH" button at the top of the leaderboard or scoreboard.
  3. Click on the "Embed on WordPress site" button as shown in the screenshot below.
  4. Copy the shortcode code to your clipboard using the blue COPY button.
  5. Your shortcode will look like this: [ keepthecore token="rvfafgignlr" ]. This is what you add to your post in the next step.

Embedding a scoreboard

3. Add the shortcode to your post

Once you have installed and activated the plugin, you can use the "shortcode" to add the board to your post. Shortcodes are a feature of WordPress, which make it easier to quickly add content to your posts.

We're assuming that you're using the new block editor ("Gutenberg"), which was released with WordPress 5.0.

  1. Start a new paragraph and type "/"
  2. Select Shortcode from the list that appears and press enter.
  3. Paste the code you got from the step above. It should look something like [ keepthecore token="rvfafgignlr" ]
  4. That's all. It should now look like the screenshot below. Save your post and your board should be visible.

Adding the shortcode scoreboard

Updating scores

Once you have embedded your leaderboard or scoreboard, you can update scores (as well as the colors, player names, etc) by logging in to and changing your scoreboard there. Your embedded scoreboard on WordPress will update automatically 🤩.