Understanding how private leagues connect to templates and generate rankings is crucial for effective league management. Private leagues operate with specific rules about how leaderboards work. This guide covers the most common questions about private league leaderboards, their relationship with templates and troubleshooting common issues.
Frequently Asked Questions
📖 Q: Can I retrieve a private league leaderboard for a specific gameId?
Unfortunately, no. Private leagues are connected only to templates, not to separate games. This means you cannot retrieve leaderboard data for a specific gameId using methods like sdk.loyalty.getLeaderboardForLeague.
💡 However, if you want your private league's ranking to include only one game ID, you can create a custom template that contains only that specific game. For example, you could create a custom game template for just one Top X game, then use this template for your league so the ranking reflects only that single game.
📖 Q: How do I create a single-game private league?
If you need a private league focused on just one specific game:
- Create a custom template containing only that one game
- Use this single-game template when creating your private league
- The resulting league will rank users based solely on predictions for that specific game
- This is the only way to achieve game-specific rankings in private leagues
Learn How to Create Templates From Scratch: Competition, Teams, Matches & Custom Game Templates
📖 Q: Why is my private league leaderboard empty or showing no rankings?
This typically happens when a private league is created after the template has already been settled (completed). Here's what occurs:
- The template cannot generate rankings because there are no active predictions within the league timeframe
- If the template's matches have already finished before the league was created, there are no new predictions to rank
- Without new predictions, the system has no data to create rankings from
📖 Q: How can I test rankings and predictions in private leagues?
To properly test private league functionality, create a test template that includes matches from leagues currently being played to make sure that you have recent predictions and rankings falling within the league's timeframe.
This approach allows you to make new predictions within your template and generate meaningful rankings falling within your private leagues' timeframe, giving you real data to test with.
📖 Q: What's the relationship between private leagues and templates?
Private leagues are fundamentally built around templates, not individual games. Understanding this connection is essential:
- Each private league is tied to exactly one template (leaderboard)
- Templates determine what games/matches are included in the league
- Rankings are generated based on all games within the template, not individual gameIds
- You cannot separate rankings by individual games within a template - the ranking encompasses the entire template's content
You can read more about Private Leagues Maintenance: Template Updates vs New Leagues here.
⚠️ Important Note: If a private league is created with a settled template containing only completed matches, it will result in empty leaderboards since there are no new predictions to rank in the league.
🎮 Template Selection Best Practice: Choose templates from active competitions to ensure immediate user engagement and ranking generation.
Further Reading
- Do you still have any questions? Check out our vast FAQ articles for multiple features: Top X, Match Quiz, Leaderboards, Classic Quiz, Either/Or, Polls, User Interests, Football Fantasy, Discussions, Staff Configuration & Private Leagues