Custom Leaderboard Widget

Overview


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 Drive
  • Fetch from URL
  • Push to Dash
The easiest way is probably from Google Drive. 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 Drive 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.

Suggestions


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