Creating a Player List

Player lists are the primary way to display groups of players with statistics on pages and team profiles. Navigate to Players > Player Lists > Add New to create one.

Title

Enter a descriptive name. This becomes the heading displayed above the list on the frontend (unless overridden by the Heading field in Details).

Format

The Format sidebar meta box has two options:

List — a table layout with configurable columns
Gallery — a photo grid layout

The format is stored as sp_format. It defaults to list if not set.

Columns Meta Box

The Columns meta box lets you select which data columns appear in the list. It shows checkboxes grouped into tabs:

Performance — the sp_performance variable types (e.g., Goals, Assists, Appearances)
Statistics — the sp_statistic variable types (e.g., calculated averages)

Check each item to include. The default columns when no selection is made are number, team, and position.

Standard columns always available regardless of this selection:

# (Squad Number) — number
Team — team
Position — position
Date of Birth — dob (shown only when the birthday display option is enabled in Player Settings)
Age — age (shown only when the age display option is enabled in Player Settings)

Details Meta Box

The Details sidebar meta box contains all filtering and sorting options.

Heading — optional text that overrides the list title as the displayed heading.

Date — filter which events are included in stat calculations based on event date. Options include: All, Today, This Week, Last Week, and a custom date range. The date range can be absolute (from/to date pickers) or relative (past N days).

Competition — filter by sp_league taxonomy. Leave blank to include all leagues.

Season — filter by sp_season taxonomy. Leave blank to include all seasons.

Position — filter by sp_position taxonomy. Leave blank to include all positions.

Team — a dropdown of all published team posts. Select a team to restrict the list to players on that team. When a team is selected, a secondary era dropdown appears with options:

All — players linked to this team as either current or past
Current — only players where this team is a current team (sp_current_team)
Past — only players where this team is a past team (sp_past_team)

Nationality — multi-select filter by country code. Leave empty to show all nationalities.

Grouping — options are None or Position. When set to Position, players are grouped under position headings.

Sort by — choose the column to sort players by. Options include Squad Number, Name, and all configured performance/metric/statistic columns.

Skip if zero? — when checked, players with a zero value in the sort column are excluded from the list.

Sort Order — Ascending or Descending.

Players — controls how the player roster is populated:

Auto — players are queried automatically based on the Competition, Season, Position, Team, and Nationality filters
Manual — a checklist of player posts appears; only checked players are included

Display (Auto mode only) — enter a number to limit how many players appear. Leave blank to show all.

Assigning to a Team Profile

Player lists can be displayed on a team page. Open the team edit screen, scroll to the Player Lists meta box, and check the lists to associate with that team. The team page template then renders those lists automatically.

Publishing

Click Publish to save and make the list available for display via shortcode or on assigned team pages.