JostleTV setup


JostleTV is an optional feature that allows you to stream your platform on any number of connected display devices. If you're interested in adding JostleTV to your platform's subscription package, please contact Support or your Customer Success Manager.


Table of contents

  1. Configuring JostleTV
  2. TV setup
  3. Linking devices & PINs for Running Programs (Computer Monitor/Smart TV)
  4. About Programs


Connecting to JostleTV

Connect to JostleTV using any of the following devices:

  • Computer monitor (PC or Mac)
  • Widescreen TV used as a computer monitor*
  • Smart TV with browser capabilities.

*16:9 aspect ratio is ideal

JostleTV can be run on the following browsers:

  • Chrome
  • Firefox
  • Safari

Recommended devices:

  • Amazon Fire TV Stick (2nd Gen)

Visit Amazon Help for Firestick setup and troubleshooting.


Configuring JostleTV

Enabling JostleTV

Before you get started, you'll need to enable JostleTV as follows:

  1. Click the Admin Settings link at the bottom of the Main Navigation
  2. Then go to the Views and Functions section and select Manage Views and Options
  3. Scroll down to JostleTV and select Enabled
  4. Click Save at the bottom of the screen 


Once you navigate to a new view or refresh your screen, you should see a TV settings option appear on the Admin Settings action menu in the Main Navigation (see image below), confirming JostleTV is enabled.


To set up a new JostleTV Program (System Admins):

  1. At the bottom of the Main Navigation, click the action menu icon (three dots) next to Admin Settings.
  2. From the popover menu, select TV settings                                                                                                                                                                                   newnaviadmintv.png                                                                                                                                                     
  3. Go to Programs and click on Add a Program...                                                                        TV_Settings_crop.png          
  4. On the Add Program page enter a Name for the Program 
  5. Then select your Program length (viewing time)
  6. Choose a User with the view permissions you want to associate with the Program (see more below).
  7. When you’ve completed the rest of the form, click Save at the top of the screen.                                                                                                                                                                                 Richclient_TV_AddProgram.png 
  8. Your Program will now appear on the TV settings screen

About Targeted users

When you target a user to a Program, it maps the Program's settings to the view permissions on that user's Profile.

TIP: For better management control, it is recommended that you use a dedicated Shared user account as the targeted user rather than assign the role to an existing user’s account.

NOTE—if you're creating a brand new user account specifically to be the targeted user, create it as an Internal user account first, and then switch it over to a View-only user (via Administration Settings > User Accounts and Data > Edit, Invite, Disable Users) after it has been activated.


TV settings vs Watch TV

The TV settings option, found in the Main Navigation on the Admin Settings action menu, is where you go to manage and run the JostleTV Programs to display on linked devices to the rest of your org (see "Linking devices" below).


The Watch TV option, found in the Main Navigation on your Profile action menu (the three dots next to your name) is a for individuals who want to run JostleTV on their own desktop. It is not meant to be used to broadcast JostleTV to your org. It runs a set program ("Long" with all Activity items included) that automatically times out after 4 hours and is not configurable via TV settings > Program




TV setup 

Setting up a widescreen TV as a PC/Mac monitor

  1. Check that you have an available HDMI port on your PC/Mac and one on your TV (they look similar to USB ports, but wider and with notched ends).
  2. Get an HDMI cable and use it to connect the ports on your PC/Mac and TV.
  3. Using your TV’s remote control, set the TV to the input you’ve connected (usually it will say something like “HDMI 1”).
  4. Mac: Your Mac screen should appear on your TV after a few moments.
  5. PC: Press the Windows button + P to open the Projector menu and select your display option (“Duplicate” will show the PC display on your PC and your TV, “Show only on 2” will only show the PC display on your TV).
  6. If you wish, adjust the Display and Sound settings in your Windows Settings/Apple System Preferences.
  7. Next, follow the "Linking a Program using a Monitor" steps below to run a Program on your PC/Mac.

Linking devices & PINs for Running Programs (via Computer monitor/Smart TV)

After you create your Programs you can run them on specific devices by linking them via a PIN code. This method also enables you to display the same Program on multiple devices (in these cases, you will still have to link the devices individually, so the Program will not be playing in sync across all of them, but the content being displayed will be the same).


Linking a Program using a Monitor or Smart TV (for System Admins)

  • If using your widescreen TV as a PC/Mac monitor, open your browser and login to your platform as the targeted user for the JostleTV Program you wish to run. 
  • If using a Smart TV, or similar display device, connect it to the internet, either directly through your router with an ethernet cable or by setting up your TV’s wireless connection (usually found in its Network Settings menu). Also, log into your Jostle platform via the Jostle desktop or mobile app.


  1. You have two options. On your monitor or SmartTV, either: download the JostleTV app from the Google Play store* and then open it (best option) OR open a browser tab** and enter the following URL:
  2. Either way, a screen with a numeric code should appear. Copy down the numeric code.                                                                                                                                                                                       Screenshot__185_.png                                                                                                                                                              
  3. Go to your platform's Main Navigation, click the action menu icon (three dots) next to the Admin Settings link.
  4. From the popover menu select TV settings
  5. Then go to Program and click on the name of the Program you want to run.
  6. Scroll down and click on "Link a device..."                                                                                                                                                                                                                                      Linked.png                        
  7. On the popup screen enter the code in the field provided.                                                                                                                                                                                         Richclient_TV_linkDevicePage.png                                                                                                                                                 
  8. Click "Link" and the selected Program will now run on the linked device.  If the linked device is your PC/Mac, your Program will automatically start running in a new browser tab, so you can switch to it right away. If your linked device is your connected Smart TV, there may be up to a 15-second delay before the Program begins.

* Make sure you're on the TV Play store. Some Smart TVs may direct users to the mobile Play store.

** The built-in browsers of some Smart TVs may cause performance issues. If your Smart TV supports the installation of other browsers, JostleTV runs best on Chrome, Firefox, and Safari.



About Programs

Program content

The items that are shown in your Program will always be the highest-ranked items in the content target you selected for your Program.

Ranking is based on a combination of three factors:

  • Time since last shown (the longer the time, the higher the ranking)
  • Time since posted (the longer the time, the lower the ranking)
  • Social metrics/Likes, comments, views (relative to the content average)

Once an item gets published, its cycle for appearing in JostleTV should generally last for about a week. However, if an item has received a high number of likes or comments, its popularity could extend the time of its cycle.

NOTE—if you don’t have enough current content, the system may pull some popular older items to cycle into the Program to avoid repeating the same current pieces over and over.


Program length

The program length options are generally used to set how much time elapses before an item is shown on your JostleTV again. They’re not used to create a set cycle of items for your program (the distribution of qualifying content is ultimately random), but rather to ensure that your items don’t get shown repeatedly within a set time frame.

As well, the length only indirectly affects the number of items you’ll see, as longer programs will spend more time displaying each item than shorter programs.

To illustrate, say a News Article and an Album are currently in your JostleTV program:

  • A Short program may show 2 Article comments and 2 photos from the Album.
  • A Long program may show 5 Article comments and 5 photos from the Album.

With that knowledge, you can determine which program length would be suitable for the area(s) where you have a display running JostleTV.

For example,

  • Short programs would work well in high traffic areas, like hallways.
  • Medium programs would be appropriate for front desk/lobby areas.
  • Long programs would work best in lunch or break rooms.


Content cycle

If you regularly publish enough content you should never see the exact same thing on JostleTV cycle after cycle after cycle. But,  as mentioned above, even if your fresh content does begin to dwindle, older items may be brought in to your cycles to keep them from getting too repetitive.






Was this article helpful?
2 out of 2 found this helpful
Have more questions? Submit a request


  • 0
    Elva Kennedy

    When you say:

    2. Open your browser on your Smart TV and enter the second attached link.

    What is the link? 


  • 0
    Jostle Team

    Hi Elva,

    If you would like to set up JostleTV beta using a PC/TV set up or Smart TV, please let your Customer Success Manager know and they will be able to send you the necessary links.



  • 0
    Matthew Bosh

    Like Jostle TV but this feature is really a bummer that it cannot be triggered off. 

    "A Long program may show 5 Article comments and 5 photos from the Album."

    Should have a program length that will show the entire album before switching, I have an album with 10 slides from a powerpoint that would be informative and better displayed if all 10 slides/photos were able to be showed until completed. 




  • 0
    Jostle Team

    Hi Matthew,

    The best way to get your suggestions made into new features is to post them in our Feature Requests forum so other users can upvote them. Suggestions that get a lot of support have a good chance of entering development. 

    (Note - for JostleTV features, post your suggestion in the General Requests category)



Please sign in to leave a comment.