Troubleshooting
Common issues and their solutions for SportsPress and SportsPress Pro.
Page Not Found (404) After Installing
Symptom: Clicking on an event, team, player, or other SportsPress page returns a 404 "Page Not Found" error immediately after activating the plugin.
Cause: WordPress permalink rules have not been regenerated to include the SportsPress custom post type slugs.
Solution: Flush the permalink cache.
Go to Settings > Permalinks in the WordPress admin.
Click Save Changes (no changes needed — just saving regenerates the rules).
This forces WordPress to rebuild the rewrite rules and register all SportsPress routes.
Events Showing "Missed Schedule"
Symptom: Scheduled (future) events display a "Missed schedule" status instead of appearing as upcoming fixtures on the frontend.
Cause: WordPress is set to use "Plain" permalinks, which does not support the date-based URL structure that SportsPress requires for scheduled event display.
Solution: Change the permalink structure to at least "Day and name."
Go to Settings > Permalinks.
Select Day and name or any custom structure.
Click Save Changes.
The "Plain" permalink setting is the only setting that breaks scheduled event display. All other permalink structures are supported.
Player List Not Showing Players
Symptom: A player list on a team page or a manually embedded player list shortcode shows no players, or fewer players than expected.
Common causes and solutions:
Player not assigned to the team — Open the player's edit screen and confirm the team is selected in the Teams meta box. The player must have the team assigned as a current team to appear in that team's player list.
Player list filtered by league/season — If the player list has a league or season filter set, only players who are also assigned to that league or season will appear. Check the player list's settings and the player's taxonomy assignments.
Player list not linked to the team — On the player list edit screen, verify that the correct team is selected. For automatically generated lists, the team page's settings must have "Player List" enabled.
Player assigned as past team only — Players assigned only as past team members will not appear in the current player list by default. Check whether the player list is configured to include past players.
League Table Showing Zeros
Symptom: All values in a league table display as zero even though events with results have been published.
Common causes and solutions:
Equation not configured — Go to SportsPress > Configure > League Table Columns and verify that each column has a valid equation. A column with no equation or an invalid variable reference will produce zero.
Events not assigned to the correct league or season — The league table is scoped to a specific league and season. Events must be assigned to those same terms. Check the event's league and season assignments.
Results not entered on events — League table calculations are driven by published event results. Confirm that the events used in the calculation are published and have results entered.
Wrong teams selected in the table — On the league table edit screen, verify that the correct teams are listed. If "Auto" mode is selected, the teams are pulled from events in the assigned league/season.
Player Stats Showing Zero
Symptom: A player's statistics in their profile or in a player list display as zero.
Common causes and solutions:
Event not published — Statistics are only calculated from published events. Draft or scheduled events are not included. Publish the events containing the player's performance data.
Results not entered — The event must have results entered (scores/outcomes). Events without results do not contribute to statistics.
Performance columns not configured — Go to SportsPress > Configure > Player Performance and confirm the columns are set up. If no performance columns exist, no statistics can be collected.
Player statistics equations reference missing variables — Go to SportsPress > Configure > Player Statistics and check that each statistic's equation references existing performance column variable names.
Player not listed in the event — Open the event's edit screen and confirm the player appears in the box score for their team.
Caching Plugin Conflicts
Symptom: SportsPress data (league tables, player lists, event results) appears stale or fails to update after changes are saved. Random sponsor rotation does not work.
Known affected plugins:
Litespeed Cache — Object caching can prevent SportsPress meta queries from returning fresh data.
W3 Total Cache — Object cache and database cache can interfere with dynamic SportsPress queries.
Solutions:
Disable object caching for pages that contain SportsPress content, or configure cache exclusions for SportsPress post type URLs (e.g., paths matching
/event/,/team/,/player/).In Litespeed Cache, add SportsPress post type slugs to the "Do Not Cache URIs" list.
In W3 Total Cache, disable "Database Cache" if table/list data is not updating after event result changes.
Sponsors use an AJAX request to bypass caching for random rotation — ensure your caching configuration does not cache AJAX responses.
PHP Errors or Blank Screens
Symptom: Admin screens show PHP warnings, fatal errors, or blank pages after upgrading PHP or SportsPress.
Minimum requirements:
PHP 5.2.4 or higher (PHP 7.4+ recommended; PHP 8.x is supported as of recent versions)
WordPress 3.8 or newer
MySQL 5.0 or greater
PHP memory limit: 64 MB minimum recommended
Solutions:
Update SportsPress Pro to the latest version, as each PHP minor version update may require compatibility fixes.
If using PHP 8.x, ensure you are on SportsPress Pro 2.7.18 or later, which contains fixes for PHP 8.x deprecation notices.
Check your server's PHP error log for the specific error message. Common PHP 8.x issues involve deprecated function signatures and null parameter handling.
Increase PHP memory limit if experiencing fatal memory errors by adding
define('WP_MEMORY_LIMIT', '128M');towp-config.php.