Variable pills: insert dynamic variables in title and meta

What it is

Variable pills are the purple chips you insert into the SEO title and meta description to add dynamic values — tokens like %%title%%, %%sitename%%, %%sep%% (separator), %%excerpt%% and %%currentyear%%. Instead of typing a fixed value, a pill stays as a token that resolves to the real value when the page renders, so titles and descriptions update by themselves when the underlying data changes (rename the site and every title that uses %%sitename%% follows).

In the AISA fields each pill is a single chip: clicking the pill button inserts the token, and the live preview substitutes the real value so you see the final text and its true length. Where your SEO plugin has its own native variables, AISA writes those — e.g. Yoast's %%sitename%% — so the dynamic behaviour is the plugin's own.

Where to find it

The pill row sits directly under the SEO title and again under the Meta description in the AISA SEO fields. In the floating panel, loading current values ("Load current") shows existing variables as pills. On the term (category/tag) screen the pills are the correct taxonomy variables (term title, term hierarchy, term description, separator, site name, page, current year).

Requirements & tier

  • Available wherever the AISA SEO title/description fields render.
  • The set of available variables comes from aisa_available_variables(), plus the active plugin's native variable syntax in integration mode.
  • No AI call is needed to insert a pill.

How to use

  1. Click into the SEO title or meta description field.
  2. Click a pill button (e.g. site name, separator, year) to insert the token as a chip at the cursor.
  3. Check the live Google preview — it shows the resolved value, not the raw token.
  4. Delete a pill as a single chip (one backspace removes the whole token).
  5. Apply the field; in integration mode AISA writes the plugin's native variable so it updates dynamically on the front end.

Questions people ask

  • What variables are available? Common ones include title, site name, separator, excerpt and current year; on terms you get term title/hierarchy/description, separator, site name, page and year.
  • Why use a variable instead of typing the value? Because it stays in sync — change the site name or year and every field using the pill updates automatically.
  • Do variables affect the length counter? The preview substitutes the real value, so the counter reflects the final rendered length, not the token.
  • Why does SEOPress show raw %%...%% in its own box? SEOPress has no pill UI; in its native box tokens stay as plain text. In the AISA panel they're shown as labelled pills, and applying a generated value replaces the token.
  • What if I delete part of a pill? Pills are inserted and removed as single chips, so you delete the whole token at once.

Troubleshooting

  • A token shows raw instead of a value. Insert it via the pill button rather than typing it; in SEOPress's own box raw tokens are expected and resolve once a value is applied.
  • Wrong variables on a category. On terms AISA offers taxonomy variables (term title, hierarchy, description…) — use those, not post variables.
  • Variable didn't carry over to the SEO plugin. In integration mode AISA maps to the plugin's native variable; make sure the field was applied.

Related

  • WooCommerce value pills on products
  • Generate the SEO title and title variants
  • Generate the meta description and variants
  • Google SERP preview and the character counters

← Back to support