Skip to main content

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.

Updated today

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

id

integer

get_the_ID()

Post ID of the Staff Directory. Required outside the Loop.

title

string/boolean

false

Override the displayed heading.

number

integer

-1

Maximum number of staff to display. -1 shows all.

columns

string/array

null

Comma-separated column slugs to override the directory's column selection.

show_all_staff_link

boolean

false

1 to show a "View all staff" link below the table (requires id).

link_posts

boolean

From settings

1 to link staff names to their profile pages. Default from the Link staff setting.

link_phone

boolean

From settings

1 to wrap phone numbers in tel: links. Default from the Link phone setting (yes).

link_email

boolean

From settings

1 to wrap email addresses in mailto: links. Default from the Link email setting (yes).

sortable

boolean

From settings

1 to enable client-side column sorting.

scrollable

boolean

From settings

1 to enable horizontal scrolling.

paginated

boolean

From settings

1 to paginate the table. Default from the Directories > Paginated setting.

rows

integer

From settings

Rows per page when pagination is active. Default from the Directories > Rows setting (10).

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"]

Did this answer your question?