Livescore & Discovery
These modules power the real-time, always-updating side of your sports site — live scores, upcoming fixtures, featured leagues and teams, and browsing/discovery interfaces that help users find the content they care about.
Core livescore modules
livescore
The flagship module. A full livescore dashboard showing today's matches across all covered leagues, with live updating scores, match status, and competition grouping.
| Variant | Description |
|---|---|
classic | Traditional grouped list with competition headers and match rows |
extended | Expanded view with additional match info (venue, referee, odds preview) |
inline | Compact inline strip for embedding in other page regions |
Key features:
- Auto-refresh — scores update in real time without page reload
- League grouping — matches grouped by competition with collapsible headers
- Status filtering — filter by live, upcoming, finished, or all
- Date navigation — browse past and future dates
- Favorite highlighting — user-favorited teams and leagues are visually emphasized
fixtures
A fixtures browser with date navigation for browsing upcoming and past matches. Unlike livescore, this module is optimized for schedule browsing rather than live tracking.
Key features:
- Date picker with prev/next navigation
- Competition grouping
- Timezone-aware display
live-ticker
A compact, real-time feed of matches designed for embedding in sidebars, headers, or secondary regions.
| Variant | Description |
|---|---|
list | Vertical list of live/upcoming matches |
ticker | Horizontal scrolling ticker strip |
card | Card-based layout with richer match details |
grid | Grid of match cards |
Filters: live, today, upcoming, finished
The ticker can be filtered to show only specific match states, making it flexible for different placements — a "live now" ticker in the header, an "upcoming today" list in the sidebar, etc.
standings-mini
A compact standings table focused on a single team's position, showing a few rows above and below. Ideal for sidebars and contextual placements where a full standings table would be too large.
team-strip
A horizontally scrollable bar of team logos. Commonly used as a quick-navigation element at the top of livescore pages or homepages, linking to each team's detail page.
tv-schedule
TV and streaming broadcast schedule showing which matches are being broadcast and on which channels/platforms.
| Variant | Description |
|---|---|
full | Complete schedule with channel logos and match details |
compact | Condensed list focused on channel and time |
The tv-schedule module requires the broadcasts feature to be active on your plan.
Browsing & navigation modules
favorites
A dedicated favorites page where users can view all their favorited teams, leagues, and matches in one place.
| Variant | Description |
|---|---|
list | Vertical list layout |
card | Card-based grid layout |
grid | Dense grid for many favorites |
compact | Minimal list for sidebar use |
countries
Country browser for navigating available leagues by country. Displays flags, country names, and the number of available competitions.
sports
Sport selection module for multi-sport sites. Allows users to switch between different sports (football, basketball, tennis, etc.).
coverage
API coverage overview showing which leagues, seasons, and data types are available for the current site configuration.
Featured & related entity modules
These modules display curated or contextual collections of leagues, teams, and matches. They are essential for homepage design, sidebar recommendations, and cross-linking between entities.
Featured and related modules pull from your site's coverage. Leagues and teams outside your configured coverage will not appear, even if manually specified by ID.
Placement guide
| Module | Best placement | Typical region |
|---|---|---|
livescore | Homepage, dedicated livescore page | Main content |
fixtures | Dedicated fixtures page, league pages | Main content |
live-ticker | Header, sidebar, any page | Header, sidebar |
team-strip | Homepage, livescore page | Above main content |
standings-mini | Sidebar on match/team pages | Sidebar |
favorites | Dedicated favorites page | Main content |
featured-leagues | Homepage, sidebar | Main content, sidebar |
featured-matches | Homepage | Main content |
related-teams | Team/league pages | Sidebar, below content |