Staff List
The [staff_list] shortcode displays a roster table of staff members from a Staff Directory, with configured columns for role, contact information, and any custom metrics.
Requires SportsPress Pro with a Club, League, or Agency license. The Staff Directories module must be enabled.
What It Displays
A data table with one row per staff member. Columns are determined by the Staff Directory post's column configuration and can be overridden with the columns parameter. Phone and email columns are optionally linked. The table supports client-side sorting and pagination.
When to Use It
Use on any page. Supply id pointing to a SportsPress Staff Directory post. Inside the Loop on a Staff Directory post page, id can be omitted.
Parameters
Parameter | Type | Default | Description |
| integer |
| Post ID of the Staff Directory. Required outside the Loop. |
| string/boolean |
| Override the displayed heading. |
| integer |
| Maximum number of staff to display. |
| string/array |
| Comma-separated column slugs to override the directory's column selection. |
| boolean |
|
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| integer | From settings | Rows per page when pagination is active. Default from the Directories > Rows setting ( |
Usage Examples
Minimal — full staff list:
[staff_list id="60"]
Coaching staff only, with 5 rows and staff profiles linked:
[staff_list id="60" number="5" link_posts="1"]
Compact list, specific columns, no pagination:
[staff_list id="60" columns="name,role,nationality" paginated="0"]
