Custom Leaderboard Widget


The Custom Leaderboard widget shows data from a spreadsheet, sorted by the column on the right. When you update your data, the leaderboard will resort the rows with an animation.

Getting Data into Dash

There are three different ways to get leaderboard data into Dash:
  • Google Sheets
  • Fetch from URL
  • Push to Dash
The easiest way is probably from Google Sheets. You can import an Excel file or build your spreadsheet right on the site. They even have great collaborative editing so other people can update the widget data if you choose to.

The second way to get data into Dash is for us to fetch it from a URL that you specify. For example, this could be generated by a website or a file stored in Dropbox.

If you have a Pro or Business account, you also have the third option of pushing your data to us. This requires a little more work to set up, but it also means your updates will show up instantly.

The data you provide needs to be in spreadsheet format (details below).

Creating the Spreadsheet

Your spreadsheet should look like this, regardless of whether you're using Google Sheets or Fetching CSV data:

You can have either 2 or 3 columns. The first row will be used as your column headers.

We sort your data by the column on the far right. On the widget configuration screen you can choose to sort with either the highest or lowest numbers on top.

Maximum Data Size

We cap the size of the data you're showing in your leaderboard at 25kb.

Update Frequency

If you're using a push widget, your dashboard will update immediately when you send it new data. If you're using Google Drive or fetching from a URL, we currently grab new data for leaderboard widgets every 30 seconds.


If you have any suggestions about how we can make the Custom Leaderboard widget better, be sure to let us know!

Feedback and Knowledge Base