Creating a League Table
League tables display team standings for a competition and season. Each table is a separate post that you configure, then embed on any page using a shortcode.
Opening the Add New Screen
Go to Teams > League Tables in the WordPress dashboard, then click Add New.
Title
Enter the name of the league table in the title field at the top of the screen. This name appears as the heading on the public-facing table and is used to identify the table in the admin.
Details Meta Box
The Details meta box on the right side of the screen contains the main configuration fields:
Heading — optional text field. When filled in, this text overrides the post title as the heading displayed above the table on the frontend.
Date — dropdown to filter which events are counted. Options include all dates, the current week, the current day, or a custom date range.
Competition (League) — taxonomy dropdown. Select the league this table belongs to. The table will only count events tagged with this league.
Season — taxonomy dropdown. Select the season this table belongs to. The table will only count events tagged with this season.
Teams — dropdown with two options:
Auto — the table automatically includes all teams assigned to the selected league and season. No manual selection is required.
Manual — a checklist appears below the dropdown showing all teams in the system. Check the teams to include. Only checked teams appear in the table.
Event Status (with results) — two checkboxes controlling which event post statuses are counted. See the article on filtering by event status for details.
Sort by — dropdown to override the default column-priority sort order. Options include Default, Name, and any defined column slug.
Sort Order — appears when a non-default sort column is selected. Choose Ascending or Descending.
Columns and Data
After publishing and returning to edit the table, the League Table meta box in the main column shows two views accessible via links:
Values — a matrix of teams and columns. Calculated values appear as greyed-out placeholder text. Individual cells can be typed over to set a static value that overrides the calculation.
Adjustments — a separate matrix where you can enter positive or negative numbers to add to (or subtract from) calculated values without replacing them.
Column checkboxes in the Values table header control which columns are visible on the frontend.
Assigning a Table to a Team Profile
A league table appears on a team's public profile page when:
The table is set to Auto and the team is assigned to the matching league and season, or
The table is set to Manual and the team is included in the manual checklist.
In both cases, open the team edit screen and check the table's checkbox in the League Tables meta box to display it on that team's profile.
Displaying on a Page
The Shortcode meta box (in the sidebar) shows a ready-to-use shortcode. Copy it and paste it into any post, page, or text widget.
Example shortcode format:
[sportspress_table id="123"]
After publishing the table, this shortcode renders the full standings table on the frontend.