Skip to main content

Using the Yoast SEO Extension

The extension's job is to make SportsPress data available to Yoast templates. Day-to-day usage is in Yoast's interface; you'll rarely interact with the extension itself.

Updated today

Using the Yoast SEO Extension

The extension's job is to make SportsPress data available to Yoast templates. Day-to-day usage is in Yoast's interface; you'll rarely interact with the extension itself.

Setting up event SEO templates

A common goal: every event page should have a meta title that includes the league and season.

  1. Go to SEO → Search Appearance → Content Types and click the Events tab.

  2. In the SEO title field, enter something like:

%%title%% — %%league%% %%season%% | %%sitename%%
  1. In the Meta description field, enter:

%%title%% on %%date%% at %%venue%%. %%league%% %%season%% match results and box score.
  1. Save.

Now every event page will produce a title like Tigers vs Lions — Premier League 2025/26 | My Sports Site and a description that pulls in the venue and date automatically.

Setting up team SEO templates

  1. Go to SEO → Search Appearance → Content Types → Teams.

  2. Configure the title to include the league:

%%title%% — %%league%% | %%sitename%%
  1. Configure the description to summarise:

%%title%% squad, results, fixtures, and statistics in %%league%% %%season%%.

Setting up taxonomy templates

For league archive pages (e.g. yoursite.com/league/premier-league/):

  1. Go to SEO → Search Appearance → Taxonomies → League.

  2. Set the title:

%%term_title%% — %%sitename%%
  1. Set the description:

All teams, fixtures, and results in %%term_title%%.

Per-post overrides

For one-off pages where the template doesn't fit:

  1. Edit the event, team, or player.

  2. Scroll to the Yoast SEO meta box.

  3. Override the SEO title and description for that specific post. Variables still work in overrides.

Troubleshooting

Symptom

Likely cause

Variables show as raw %%league%% text in search results

The taxonomy is not assigned to the post; assign a league term and re-save the post

%%sp_teams%% empty on event

The event has no teams selected in the SportsPress meta box; assign teams first

Variables missing from the dropdown

Yoast SEO or SportsPress is inactive; check both are running

Custom taxonomy variables not appearing

Custom taxonomies must be registered through sportspress_taxonomies, not directly via register_taxonomy

Did this answer your question?