Player Metrics
Player Metrics are static data fields attached to individual players — for example, Height, Weight, or Date of Birth. Each metric is a WordPress post of type sp_metric.
Metrics are not calculated from events. The value for each metric is entered manually on the player's edit screen, and it stays fixed unless you change it. This distinguishes them from Player Statistics, which are calculated dynamically from event performance data.
Navigate to SportsPress > Configure to see the list, or use the View All link in the Player Metrics section.
Fields
Each metric has the following fields:
Label — The display name shown on player profile pages (for example: Height, Weight, Date of Birth).
Variable — The slug used to reference this metric in Player Statistics equations, prefixed with
$(for example:$height). Set in the Details meta box. The variable is available as a token in the equation builder when building Player Statistics.Visible — Whether this metric appears in the player profile by default. Options are Yes and No. Shown in the Details meta box. The tooltip reads "Display in player profile?"
Description — Internal notes displayed only in the admin dashboard.
The Configure screen summary table shows Label, Variable, and Description for each metric.
How Metrics Differ from Statistics
The distinction between metrics and statistics is:
Metrics — Entered manually per player. The value does not change based on events. Examples: Height, Weight, Nationality, Jersey Number.
Statistics — Calculated by an equation from performance data across events. The value updates automatically as new events are recorded. Examples: Total Goals, Goals per Game, Win Percentage.
Because metrics are static, they are also available as inputs in Player Statistics equations. For example, a hypothetical "BMI" statistic could divide a player's Weight metric by the square of their Height metric.
Where Metric Values Are Entered
Metric values are entered on the individual player's edit screen, not on events or in Configure. When you edit a player post, a Metrics section appears listing each defined metric with an input field. Enter the value there and save the player.
Adding a Metric
Go to SportsPress > Configure.
In the Player Metrics section, click Add New.
Enter the Label (title) in the post title field.
In the Details meta box, set the Variable and Visible options.
Optionally add a description in the Excerpt field.
Set the display Order in the Attributes box.
Click Publish.
After publishing, the metric will appear as an input field on every player's edit screen.