List Layout
The List format renders players in a data table. It is the default format for player lists.
Setting the Format
On the player list edit screen, open the Format sidebar meta box and select List.
Table Structure
The rendered table has:
A header row with column labels
One row per player
A first column showing either the squad number or a rank number
First Column: Number vs. Rank
When Sort by is set to Squad Number or Name, the first column shows the actual squad number from each player's
sp_numbermeta. The column header is#.When Sort by is set to any statistic column, the first column shows the player's rank (1, 2, 3, ...) based on sort position. The column header changes to Rank.
Default Column Set
When no columns are selected in the Columns meta box, the list shows: #, Player, Team, Position.
When columns are selected, they appear after the Player column in the order defined by the menu_order of the performance/statistic post types in Configure.
Sortable Tables
Column headers in the list are clickable for client-side sorting by default. This behavior is controlled by the global setting sportspress_enable_sortable_tables (default: yes). It can be overridden per-embed using the sortable parameter in the shortcode.
Responsive Tables
The responsive mode collapses columns on small screens, showing data labels inline. Controlled by sportspress_enable_responsive_tables (default: no). Override with the responsive shortcode parameter.
Scrollable Tables
Horizontal scrolling is available for wide tables. Controlled by sportspress_enable_scrollable_tables (default: yes).
Pagination
Pagination splits long lists into pages. Controlled by:
sportspress_list_paginatedsetting (default:yes)sportspress_list_rowssetting (default:10) — number of rows per page
Both can be overridden with the paginated and rows shortcode parameters. Setting paginated="0" disables pagination entirely.
Player Name Display Options
In SportsPress > Settings > Players > Player Lists, two options affect name cells:
Photos — when enabled, a player thumbnail appears next to the name
Flags — when enabled, a nationality flag appears next to the name
Linking Player Names
Player names link to their individual player profile pages by default. Controlled by sportspress_link_players (default: yes). Override with link_posts="0" in the shortcode.
Grouping by Position
Setting Grouping to Position in the Details meta box splits the table into sections, one per position. A heading (default <h4>) appears before each position group. The heading tag can be changed with the grouptag shortcode parameter.
Show All Players Link
A "View all players" link can be added below the list by setting show_all_players_link="1" in the shortcode. It links to the player list's permalink.