> ## Documentation Index
> Fetch the complete documentation index at: https://docs.statusstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# TV Dashboard Guide
> Display StatusStack on large screens, NOC walls, and TVs for real-time monitoring visibility
## Overview
**Pro or Enterprise plan required.** The TV Dashboard is available on [Pro and Enterprise plans](/account/subscription-plans). Upgrade to display real-time status on large screens and NOC walls.
The TV Dashboard is a large-screen optimized view designed for NOC (Network Operations Center) walls, office TVs, and monitoring displays. It provides real-time status visibility across all your Stacks with auto-refresh and rotation capabilities.
***
## Accessing the TV Dashboard
### From Your Dashboard
1. Navigate to **Monitoring** → **TV Dashboard** in the sidebar
2. This opens the TV Dashboard settings page
3. Click **"Launch TV Dashboard"** to open the full-screen view
### Direct URL Access
For authenticated users:
```
https://statusstack.com/tv
https://statusstack.com/tv/{organization-slug}
```
***
## TV Dashboard Features
Text and status indicators sized for viewing from 10-15+ feet
Automatic data refresh every 10-60 seconds
Cycle through multiple pages when you have many Stacks
Live scrolling feed showing active incidents
***
## Display Settings
Configure the TV Dashboard from **Monitoring** → **TV Dashboard**:
### Display Size
| Size | Best For |
| --------------- | ------------------------------- |
| **Normal** | Desktop viewing, small screens |
| **Large** | TV viewing from 10-15 feet |
| **Extra Large** | NOC wall displays from 15+ feet |
### Refresh Interval
How often the dashboard polls for new data:
* 10 seconds (more responsive, higher server load)
* 15 seconds (recommended)
* 30 seconds (balanced)
* 60 seconds (lower resource usage)
### Rotation Interval
How long to display each page of Stacks before rotating:
* 15 seconds
* 30 seconds (recommended)
* 60 seconds
* 2 minutes
### Additional Options
| Setting | Description |
| ---------------------- | ------------------------------------------- |
| **Show Stack Headers** | Display Stack names above each panel |
| **Show Incident Feed** | Display scrolling incident banner at bottom |
| **24-Hour Time** | Use 24-hour format instead of AM/PM |
***
## Public Share Link
Share your TV Dashboard without requiring authentication - perfect for NOC displays where you can't log in.
### Enabling Public Sharing
Navigate to **Monitoring** → **TV Dashboard**
Toggle **"Enable Public Share Link"** to ON
Copy the generated share URL:
```
https://statusstack.com/tv/share/{token}
```
Open the URL on your NOC display in a browser
### Security Considerations
The share link provides read-only access to your status dashboard. Anyone with the link can view your Stack status. Do not share this URL publicly unless intended.
**Best Practices:**
* Regenerate the token periodically
* Use organization-level access controls
* Disable sharing when not needed
* Use authenticated access for sensitive environments
### Regenerating the Share Token
If your share link is compromised or you want to rotate credentials:
1. Navigate to **TV Dashboard** settings
2. Click **"Regenerate Token"**
3. Previous share links will immediately stop working
4. Share the new URL with authorized displays
***
## URL Parameters
Customize the TV Dashboard via URL parameters for different displays:
### Stack Filtering
Display specific Stacks:
```
/tv?stacks=production,staging,api-services
```
### Team Filtering
Display only Stacks from a specific team:
```
/tv?team={team-uuid}
```
### Refresh & Rotation
Override settings via URL:
```
/tv?refresh=30&rotate=true&interval=60
```
### Complete Example
```
https://statusstack.com/tv/{org}?stacks=production,staging&refresh=15&rotate=true&interval=30
```
| Parameter | Description | Values |
| ---------- | --------------------------- | -------------------- |
| `stacks` | Comma-separated Stack slugs | `production,staging` |
| `team` | Filter by team UUID | UUID string |
| `refresh` | Refresh interval (seconds) | 10-60 |
| `rotate` | Enable page rotation | `true` / `false` |
| `interval` | Rotation interval (seconds) | 15-120 |
***
## Display Layout
The TV Dashboard automatically arranges Stacks in a grid:
| Stack Count | Grid Layout |
| ----------- | ------------------------ |
| 1 | Full-screen single panel |
| 2 | 2 columns |
| 3 | 3 columns |
| 4 | 2x2 grid |
| 5-6 | 3 columns, 2 rows |
| 7+ | Paginated with rotation |
### Status Colors
Each Stack panel is color-coded by status:
| Status | Border Color | Meaning |
| -------------- | ------------ | --------------------------------- |
| 🟢 Operational | Green | All services healthy |
| 🟡 Degraded | Yellow | Some services experiencing issues |
| 🔴 Outage | Red | Critical failures detected |
| ⚪ Unknown | Gray | Status not yet determined |
***
## Incident Feed
The bottom of the screen displays a scrolling feed with active incidents:
**Feed Information:**
* Source name and logo
* Component affected
* Incident duration
* Status severity
**Toggle:** You can hide the feed in TV Dashboard settings if not needed.
***
## Best Practices
### For NOC Environments
* [ ] Use "Extra Large" display size for wall-mounted displays
* [ ] Set refresh interval to 15-30 seconds
* [ ] Enable rotation if monitoring 6+ Stacks
* [ ] Use the public share link to avoid login sessions expiring
* [ ] Configure browser to auto-start in kiosk/fullscreen mode
* [ ] Test audio alerts if using webhooks to external systems
### Browser Configuration
**Recommended Setup:**
1. Use Chrome/Firefox in kiosk mode
2. Disable screensaver on the display computer
3. Set browser to clear cache on start
4. Configure auto-restart on crash
**Chrome Kiosk Mode:**
```bash theme={null}
google-chrome --kiosk --app=https://statusstack.com/tv/share/{token}
```
**Firefox Kiosk Mode:**
```bash theme={null}
firefox --kiosk https://statusstack.com/tv/share/{token}
```
### Multiple Displays
For multi-monitor setups, use different URLs per display:
**Display 1 - Production:**
```
/tv?stacks=production-api,production-web,production-db
```
**Display 2 - Staging:**
```
/tv?stacks=staging-api,staging-web
```
**Display 3 - Third-Party Services:**
```
/tv?stacks=external-services
```
***
## Keyboard Controls
When viewing the TV Dashboard with keyboard access:
| Key | Action |
| ------- | --------------------- |
| `Space` | Pause/Resume rotation |
| `←` | Previous page |
| `→` | Next page |
| `R` | Force refresh |
| `F` | Toggle fullscreen |
***
## Troubleshooting
### Dashboard Shows "No Stacks Found"
**Check:**
1. Organization has active Stacks
2. Selected Stacks filter isn't too restrictive
3. Team filter matches existing Stacks
4. URL parameters are correctly formatted
### Share Link Not Working
**Check:**
1. Sharing is enabled in TV Dashboard settings
2. Token hasn't been regenerated
3. URL is complete and correctly copied
4. Organization hasn't disabled sharing
### Display Issues
**Screen too small/large:**
* Adjust display size setting
* Check browser zoom level (should be 100%)
**Content cut off:**
* Use fullscreen/kiosk mode
* Check display resolution settings
**Slow updates:**
* Increase refresh interval
* Check network connectivity
* Verify StatusStack service status
***
## Related Documentation
Main dashboard features
Understanding Stack organization
Get alerts alongside TV display
Multi-client monitoring displays