Optimize your dashboard for TV

Geckoboard makes it easy for you to build a dashboard specifically for viewing from a distance on TV screens or monitors. You'll arrange your widgets on a fixed grid layout, ensuring accurate proportions for screen aspect ratios.

To learn more about selecting the appropriate hardware and connecting your TV display with Geckoboard, read this guide.


If you're an existing Geckoboard customer we encourage you to try our new look dashboards and layouts optimized for big screens. Just click the Try new layout button at the top of your dashboards to convert to the new layout.

Important note

You cannot apply Custom CSS to style your dashboard using the fixed grid layout. If you use Custom CSS and want to build your dashboard so that it's optimized for TV, try our custom theme options.

Create a new dashboard optimized for TV

To create a new dashboard intended for display on a big screen, follow these steps:

  1. In the top left hand corner of your screen, click  Dashboards.
  2. At the bottom of the pop-up menu, click Add dashboard.
  3. Give your new dashboard a name and make sure Optimize layout for big screen is on .Add new dashboard for the big screen
  4. Click Add dashboard.
  5. Your new dashboard will scale to fit your screen as you're building it, allowing you to see exactly how it's going to look on your TV. Your widgets will also snap to the grid, so you don't have to be precise about alignments.TV dashboard grid with widgets


    There are two types of grid layouts: Standard and Dense. Standard is best for focusing on a few key metrics, Dense allows more data. Read more


    Vertical scroll is incompatible with landscape TV dashboards, which means that your widgets cannot be positioned off the fixed grid. This guarantees your dashboard to look great on any standard TV screen used in landscape mode.

    It is not currently possible to create TV dashboards in portrait layout.

Display a dashboard optimized for TV

Dashboards with optimized-layout for TV screens have two sections:

  1. Grid area
  2. "Off canvas" areaTV dashboard grid with widgets in the off canvas area

 All widgets in the grid will display on your TV once you set the dashboard up using Send to TV.

There are two types of grid layouts: Standard and Dense.

Standard (default)
Creates a 6w x 3h grid that is best for focusing on a few key metrics.
creates a 8w x 4h grid that is convenient for displaying more data.

To set the type of grid of your dashboard, follow these steps:

  1. Click Settings from the navigation menu.settings options
  2. Select Customize appearance.
  3. Click Show to open the Layout and display settings.
  4. Select the density of your dashboard grid.grid layout options
  5. When you're finished, click Save.


Widgets in the "off grid" area will remain hidden and won't display on Screens (or shared links).


Use the "off canvas" area to try out new metrics and visualizations without inconveniencing anyone that’s looking at the screen. 

Migrate widgets from your column dashboard layout

If you'd like to convert your existing column dashboard layout to one optimized for displaying on a TV, you can create a new fixed grid layout dashboard and make copies of the widgets from your existing dashboard.

If you cannot fit all your existing dashboard widgets into the fixed grid layout, consider prioritizing them or creating a loop.

Get in touch

If adding a new dashboard will exceed your plan's allocation, drop us a line and we can add a temporary additional dashboard to your account in order to migrate your widgets.

Convert to a column dashboard layout

If you no longer need to display your dashboard solely on a TV, you can choose to convert it to a column dashboard layout. This will allow you to fit more widgets on your dashboard than the fixed grid allows.

To convert your dashboard to a column layout, follow these steps:

  1. Select the dashboard you wish to convert.
  2. Click Settings from the navigation menu.settings options
  3. From the drop-down menu, click Dashboard settings.
  4. In the Dashboard settings modal, click the Convert to column dashboard layout link.settings options
  5. Click Save.
Was this article helpful?

Awesome! 👍 Thanks so much for your feedback!

Sorry about that! Start a conversation now.

We're ready to help, 24 hours a day, 5 days a week

Get support
  • Fernanda Customer Success Avatar


  • Hariharan Customer Success Avatar


  • Fernanda Customer Success Avatar


  • Luis Customer Success Avatar


  • Richard Customer Success Avatar


  • Fernanda Customer Success Avatar


  • Heather Customer Success Avatar


  • Heather Customer Success Avatar