WordPress SEO Plugin by Rank Math

Geo Controller provides geographic tag replacement that can be used alongside Rank Math SEO to create location-aware SEO titles and meta descriptions.

By combining Geo Controller’s IP geolocation data with Rank Math’s metadata settings, you can personalize supported SEO output using geographic placeholders such as %%country%%, %%city%%, and %%region%%.

This functionality provides additional flexibility for geographic content personalization. However, location-dependent metadata requires careful configuration, especially on websites targeting organic search traffic.

How the Integration Works

Geo Controller includes a geographic tag replacement mechanism that processes supported placeholders in the generated WordPress HTML.

When Rank Math preserves a supported geographic placeholder in its generated metadata, Geo Controller can replace it with information associated with the current visitor’s IP address.

For example, %%country%% can become United States for a visitor detected in the United States or United Kingdom for a visitor detected in the United Kingdom.

This mechanism is separate from Rank Math’s native variable registration system. Geo Controller placeholders may not appear in Rank Math’s list of selectable variables, and compatibility depends on whether the installed Rank Math version preserves the placeholders in its HTML output.

How to Use Geo Controller with Rank Math SEO

  1. Install and activate Rank Math SEO.
  2. Install and activate Geo Controller.
  3. Verify that Geo Controller is returning the expected geographic information.
  4. Open a WordPress post or page and locate its Rank Math SEO settings.
  5. Open the SEO snippet editor and find the Title or Description field.
  6. Enter a supported Geo Controller placeholder, such as %%country%%, as literal text.
  7. Save the page and inspect the generated HTML metadata to verify whether the placeholder was replaced.

You may also test geographic placeholders in supported Rank Math metadata templates. However, compatibility depends on the specific field and how Rank Math processes its variables.

Available Geographic Tags

Geo Controller provides geographic placeholders that can be used in supported WordPress output.

Some useful examples include:

Geo Controller Tag Description
%%country%% Detected visitor country name.
%%country_code%% Two-letter country code.
%%city%% Detected city name.
%%region%% Detected region or state.
%%continent%% Detected continent name.
%%currency%% Currency code associated with the detected location.

The actual values depend on the geographic information available for the current request.

For additional properties and examples, visit the Geo Controller Tags documentation.

Note: Geo Controller geographic placeholders are not necessarily registered as native Rank Math variables. Some geographic properties are excluded from general HTML replacement, and placeholders that Rank Math processes or removes before HTML output may not be available for replacement.

Using Geographic Tags in Rank Math SEO

Geo Controller placeholders can be combined with ordinary text to create location-aware SEO metadata, provided they are preserved in the final HTML.

Example: Geographic SEO Title

Suppose your company provides services internationally.

You could enter the following title template:

Professional Services in %%country%% | Example Company

For a request where Geo Controller detects the United States, the resulting title may be:

Professional Services in United States | Example Company

Example: Geographic Meta Description

You can also include geographic placeholders in a meta description:

Explore our products and services available in %%country%%. Contact our team to learn more.

For a visitor detected in the United Kingdom, the generated description may become:

Explore our products and services available in United Kingdom. Contact our team to learn more.

These examples demonstrate geographic text replacement. They do not guarantee that search engines will index or display every geographic variation.

Rank Math SEO Settings Example

The screenshot below illustrates the historical use of Geo Controller geographic placeholders within Rank Math SEO settings.


Geo Controller geographic placeholders in Rank Math SEO settings

The Rank Math interface may differ depending on your installed version. Modern versions may process custom placeholders differently from the interface shown in this screenshot.

How to Verify Geographic Metadata

Do not rely exclusively on the SEO preview displayed in the WordPress administration area.

To verify the generated metadata:

  1. Save the post or page containing your geographic placeholder.
  2. Open the public page in your browser.
  3. Use View Page Source to inspect the server-generated HTML.
  4. Locate the page’s <title> element or <meta name="description"> tag.
  5. Check whether the geographic placeholder was replaced with the expected value.
  6. Repeat the test using different visitor locations where possible.

If the placeholder remains unchanged, verify that Rank Math preserved the original text and that Geo Controller processed the generated HTML.

If the placeholder is missing entirely, Rank Math may have removed or transformed it before Geo Controller could perform the replacement.

Important SEO Considerations

Geographic metadata personalization is not the same as an international SEO strategy.

Search engines may crawl your website from locations that differ from those of your intended audience. As a result, they may encounter only one geographic variation of your page’s metadata.

For example, a search engine crawler connecting through a United States IP address may receive metadata intended for United States visitors, even if your website also generates different metadata for European visitors.

This means that using geographic placeholders does not guarantee improved rankings or country-specific search engine listings.

Google Search and Geographic Content

Google recommends using accessible, locale-specific URLs and appropriate hreflang annotations when websites need distinct regional or language versions of their content.

IP-based metadata personalization alone is not a substitute for these practices.

For additional guidance, see Google’s documentation on locale-adaptive pages.

Avoid Misleading Metadata

Geographic placeholders should only be used where the resulting metadata accurately describes the content available on the page.

For example, displaying a country-specific service title is inappropriate if the business does not actually provide that service in the selected country.

Do not use this functionality to deliberately show misleading content to search engines or create geographic claims that the page cannot support.

Page Caching and Dynamic Metadata

Geo Controller’s geographic tag replacement processes values during WordPress HTML generation.

If a caching plugin, reverse proxy, or CDN stores the generated HTML, subsequent visitors may receive the same cached SEO metadata regardless of their individual location.

For example, a page cached with a title containing United States may continue serving that title to visitors from other countries until the cache is refreshed or otherwise separated by location.

Geo Controller’s general HTML tag replacement does not independently bypass full-page caching or automatically create separate cached versions for each country.

Review your caching configuration before enabling location-dependent metadata on production pages.

Rank Math SEO can generate metadata used by social platforms, including Open Graph information.

However, social media platforms generally retrieve page information using their own automated crawlers.

As a result, location-dependent metadata may reflect the crawler’s detected location rather than the location of the person sharing the link or viewing the content.

Social platforms may also cache previously retrieved metadata, so geographic variations are not guaranteed to appear in individual link previews.

If consistent social sharing titles and descriptions are important, consider using stable metadata rather than relying on visitor-specific geographic placeholders.

Privacy and Sensitive Information

Not every geographic or technical property is appropriate for public SEO metadata.

Avoid inserting visitor IP addresses, precise coordinates, network identifiers, or other potentially sensitive information into titles, descriptions, and social metadata.

For general SEO use, broad geographic information such as a country or region is usually more appropriate than individual visitor identifiers.

  • Use geographic placeholders only where they provide accurate and relevant information.
  • Verify that your Rank Math version preserves custom placeholders in the generated HTML.
  • Prefer stable SEO titles and descriptions for important organic search landing pages.
  • Use dedicated regional URLs and hreflang where appropriate for international SEO.
  • Verify the generated HTML metadata rather than relying exclusively on the Rank Math editor preview.
  • Check the effects of page caching and CDN configuration.
  • Test how social media crawlers retrieve and cache page metadata.
  • Avoid including sensitive visitor information in public metadata.
  • Do not assume that geographic personalization will improve search rankings.

For Developers

Geo Controller provides a general HTML tag replacement mechanism for supported geographic properties.

In the publicly available implementation, the CFGP_Public::output_buffer_callback() method processes geographic placeholders using data supplied by the Geo Controller API.

Developers can customize the data passed to the general tag replacement mechanism through the cfgp/render/tags WordPress filter.

This mechanism is separate from Rank Math’s native variable registration system.

For advanced integrations, developers should inspect the installed versions of both plugins and use their supported APIs where appropriate.

For additional technical information, see the Geo Controller PHP Integration documentation.

Important: Geo Controller provides geographic placeholders as an optional customization mechanism. Their use inside Rank Math metadata depends on whether the installed version preserves them in the generated HTML. Incorrect or misleading metadata, inadequate caching configuration, or poorly planned geographic targeting can negatively affect how search engines and social platforms interpret your pages. SEO improvements are not guaranteed.

Was this page helpful?
Yes No