Custom Textbox Widget

Overview


Custom Textbox widgets allow you to show simple text on your dashboard. Text widgets are different from basic value widgets because text widgets:
  • Wrap content to new lines
  • Have a specific text size
  • Have optional formatting
  • Have a transparent background


Getting Data into Dash


There are two different ways to get Custom Textbox Widget data into Dash. The easiest way is for us to fetch it from a URL that you specify. Right now we grab new data for textbox widgets every 30 seconds, but we may decide to change this later.

If you have a Pro or Business account, you also have the 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 plain text format (details below).

Source Data


The format for the widget's source data is incredibly simple. It's just the content that you want displayed.

So, if you want to show the phrase "Raptors know no fear." inside of your basic value widget, just open your favorite text editor, type in the phrase, and save the file as plain text.
Raptors know no fear.
This will show on your dashboard as:



The next step is to get this text file into Dash. We recommend that beginners fetch data from a URL, but pushing your data to us works great too.

Text Formatting


Custom Textbox widgets support bold, italics, and underline with the following tags:
  • <b>
  • <i>
  • <u>
For example, if you wanted to make "no" bold, your text file would look like:
Raptors know <b>no</b> fear.


You can also change the font size. Just wrap your text in a span with one of the following classes:
  • wysiwyg-font-size-x-small
  • wysiwyg-font-size-small
  • wysiwyg-font-size-medium
  • wysiwyg-font-size-large
  • wysiwyg-font-size-x-large
  • wysiwyg-font-size-xx-large
For example, to display "fear" with an xx-large font, your text file would look like:
Raptors know <b>no</b> <span class="wysiwyg-font-size-xx-large">fear</span>.

Maximum Data Size


We cap the size of the text being displayed at 2,000 characters.

Suggestions


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

Feedback and Knowledge Base