---
title: "TV Listings"
canonical: "https://docs.pbs.org/space/B3/4751476/TV%20Listings"
format: markdown
---
> Macro (toc)

## Overview

The TV Listings component is station-specific and presents users with a TV programming grid.

## Important notes

- <span style="color: #003366">To use this component, you must have a </span>JAWS (JavaScript Widget Service) <span style="color: #003366">integration key assigned to your site in the </span><span style="color: #003366">[site settings section](https://docs.pbs.org/space/B3/4751441/Setting+Up+Your+Site#Integrations)</span><span style="color: #003366">. If you do not have one, </span><span style="color: #003366">[submit a support ticket](http://digitalsupport.pbs.org/support/tickets/new)</span><span style="color: #003366">.</span>
- <span style="color: #003366">Do not place this component on the same page as the </span><span style="color: #003366">[What's On component](https://docs.pbs.org/space/B3/4751480/What's+On+%2F+What's+On+Kids)</span><span style="color: #003366">. They must be placed on separate pages.</span>

## Example

![image](media://78172680-9d98-4f42-a17e-c89ea6e6676a)

## How to implement TV Listings

<details>
<summary>View the tutorial</summary>

> Macro (multimedia)
</details>

> ⚠️ **When your site admin ****[set up your Bento site](https://pbs-docs.atlassian.net/wiki/spaces/B3/pages/4751441)****, a JAWS API key should have been assigned so that when you add the TV Listings component to your site, the schedule automatically appears. ****[Request a JAWS API key](http://digitalsupport.pbs.org/support/tickets/new)**** if you do not have one.**

- In a block of the content section of your website, click the **plus sign** (Figure 1.1) and click** tv listings** (Figure 1.2).

Figure 1

![image](media://f7998d70-f97d-4fe1-a38a-12c541f380c7)

- Your component has been added. Hover over the component and click the cog icon to see the settings for this component (Figure 2).

Figure 2

![image](media://3a5aa383-3af4-4ccb-8d5a-0e20d9160002)

- The API Key that was added for you when you [set up your site](https://pbs-docs.atlassian.net/wiki/spaces/B3/pages/4751441) appears in the left side bar (Figure 3.1).
- Click **Save** to save the page and click **Preview** to view your component in a browser (Figure 2.2).

Figure 3

![image](media://7494b1df-9e18-4e64-8681-7d37527585b0)

- Your TV Listings component displays (Figure 4).

Figure 4

![image](media://2024b5a1-05ae-45cb-83fe-6a46b9f2806f)