Display a list of competitions with logos, country flags, and links. Perfect for navigation pages showing all available leagues and tournaments.
Basic Usage
[anwpfl-competition-list]This displays all competitions with logos and country flags.
All Parameters
Selection Parameters
| Parameter | Default | Description |
|---|---|---|
league_ids |
(all) | Filter by League IDs (comma-separated). Empty for all |
season_ids |
(all) | Filter by Season IDs (comma-separated). Empty for all |
include_ids |
(empty) | Only show these Competition IDs (comma-separated) |
exclude_ids |
(empty) | Hide these Competition IDs (comma-separated) |
Display Parameters
| Parameter | Default | Description |
|---|---|---|
group_by |
(none) | Group competitions: country (expanded) or country_collapsed (accordion) |
display |
competition | Label format: empty (Competition), league (League name), league_season (League – Season) |
show_logo |
yes | Show competition logos. Use no to hide |
show_flag |
big | Country flag: big, small, or empty to hide |
Examples
Example 1: All Competitions
When to use: Main leagues/competitions overview page.
[anwpfl-competition-list]Result: All competitions listed with logos and flags.
Example 2: Grouped by Country
When to use: International site with many countries.
[anwpfl-competition-list group_by="country"]Result: Competitions grouped under country headings.
Example 3: Collapsed Country Groups
When to use: Many countries, cleaner interface with accordion.
[anwpfl-competition-list group_by="country_collapsed"]Result: Clickable country headers that expand to show competitions.
Example 4: Current Season Only
When to use: Show only active competitions.
[anwpfl-competition-list season_ids="12"]Result: Only competitions from season 12.
Example 5: Specific Leagues
When to use: Featured leagues section.
[anwpfl-competition-list league_ids="1,3,5,7"]Result: Only competitions from the specified leagues.
Example 6: League Name Display
When to use: When competition titles are too long.
[anwpfl-competition-list display="league"]Result: Shows “Premier League” instead of “Premier League 2024/25”.
Example 7: Without Flags
When to use: Single-country site or minimalist design.
[anwpfl-competition-list show_flag=""]Result: Competition list without country flags.
Tip
Use group_by="country_collapsed" for sites with many countries – it keeps the page clean while providing easy access to all competitions.
Troubleshooting
No competitions showing?
- Verify competitions are published
- Check if filters (league_ids, season_ids) are too restrictive
- Ensure competitions have main stages set up
Missing country groupings?
- Leagues must have a country assigned
- Check League settings in admin
Related
[anwpfl-competition-header]– Single competition header[anwpfl-clubs]– Club logos from competition