Directory List Layout
The List format displays staff members in a table with columns for name, job, phone, and email. Select List in the Layout meta box when editing a Staff Directory.
This feature is part of SportsPress Pro.
Column Visibility
In the Staff Directory data table, checkboxes in the header row control which columns appear in the public output:
Job — Shows the staff member's assigned job titles.
Phone — Shows the phone number (from
sp_phonepost meta).Email — Shows the email address (from
sp_emailpost meta).
The Name column is always visible and cannot be hidden.
Global Contact Link Settings
Two settings in SportsPress → Settings → Staff → Contact Info control link behaviour globally:
Link phone — When enabled, phone numbers render as
tel:links (option ID:sportspress_staff_link_phone, default: yes).Link email — When enabled, email addresses render as
mailto:links (option ID:sportspress_staff_link_email, default: yes).
[staff_list] Shortcode
The list format is embedded using the [staff_list] shortcode. Copy the ready-made code from the Shortcode sidebar panel on the directory edit screen, or write it manually.
Basic Usage
[staff_list id="99"]
Parameters
Parameter | Default | Description |
| (empty) | Directory post ID — required unless the shortcode is inside The Loop |
|
| Number of staff to display; |
| (empty) | Comma-separated column slugs to display (e.g. |
|
| Link staff names to their individual profile pages |
|
| Wrap phone numbers in a |
|
| Wrap email addresses in a |
|
| Enable sortable column headers |
|
| Enable responsive mode |
|
| Enable pagination |
|
| Rows per page when paginated |
|
| Set to |
Example
[staff_list id="99" number="5" columns="role,phone" paginated="0" show_all_staff_link="1"]