Geo Controller Tags

Geo Controller Tags allow you to insert dynamic geographic information directly into HTML content without writing PHP code or using traditional WordPress shortcodes.

These special placeholders are automatically replaced with geographic information associated with the current visitor, such as their detected country, country code, city, region, continent, or IP address.

Geo Controller Tags are especially useful when working with WordPress content, theme templates, page builders, and other areas where geographic information needs to be inserted into existing text or HTML.

Where Can You Use Geo Controller Tags?

Geo Controller Tags can be used in supported HTML content processed by the plugin, including:

• Navigation menus — personalize menu labels with geographic information.
• Widgets — display location-specific information in widget content.
• Input fields and forms — populate supported HTML attributes with geographic values.
• Meta tags — insert geographic information into supported HTML metadata.
• Page builders — include dynamic geographic information in text and HTML elements.
• Theme templates — display geographic values in HTML generated by WordPress themes.
• Custom HTML — insert location information into supported HTML output.

Important: Geo Controller Tags are processed in supported HTML output. They are not PHP variables and should not be assumed to work in every JavaScript string, external file, HTTP response, or content generated outside the plugin’s processing pipeline.

How Geo Controller Tags Work

Each tag consists of a geographic property name enclosed between two pairs of percentage symbols.

For example, the following tag represents the visitor’s detected country:

%%country%%

If Geo Controller identifies the visitor’s country as the United States, the rendered content may display:

United States

You can also combine geographic tags with regular text.

For example:

Welcome, visitor from %%country%%!

For a visitor detected in Germany, the rendered result would be:

Welcome, visitor from Germany!

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

Using Multiple Geographic Tags

You can combine multiple tags within the same HTML element or text block.

For example:

Your location: %%city%%, %%country%%

A possible rendered result:

Your location: Berlin, Germany

Another example using a country code:

Detected country code: %%country_code%%

Possible result:

Detected country code: DE

Property names must correspond to geographic information supported by Geo Controller. If a particular property is unavailable, the expected value may not be displayed.

Using Geographic Tags in HTML

Geo Controller Tags can be inserted into supported HTML elements and attributes.

Example: HTML Text

<p>Our services are available in %%country%%.</p>

Example: Input Field

<input type="hidden" name="visitor_country" value="%%country%%">

When the HTML output is processed by Geo Controller, the placeholder can be replaced with the detected country value.

Security notice: Hidden input values can be modified by visitors. Do not use them as trusted proof of geographic location for access control, payments, taxation, or other security-sensitive operations.

Example: HTML Meta Description

<meta name="description" content="Explore our services in %%country%%.">

This example demonstrates geographic replacement inside an HTML attribute. Whether the resulting metadata is indexed by search engines depends on crawling, caching, and other SEO factors.

Available Geo Controller Tags

The following table lists the geographic properties available through Geo Controller’s tag reference.

To use a property as a Geo Controller Tag, surround its name with two percentage symbols on each side, as shown in the examples above.

The table is generated dynamically by Geo Controller:

%%flag%%

%%ip%%

%%ip_version%%

%%ip_number%%

%%ip_dns_host%%

%%ip_dns_provider%%

%%isp%%

%%isp_organization%%

%%isp_as%%

%%isp_asname%%

%%continent%%

%%continent_code%%

%%country%%

%%country_code%%

%%country_code_3%%

%%country_code_numeric%%

%%region%%

%%region_code%%

%%district%%

%%city%%

%%postcode%%

%%address%%

%%calling_code%%

%%latitude%%

%%longitude%%

%%timezone%%

%%timezone_offset%%

%%timezone_abbreviation%%

%%timestamp%%

%%timestamp_readable%%

%%current_date%%

%%current_time%%

%%currency%%

%%currency_symbol%%

%%currency_converter%%

%%base_convert%%

%%base_convert_symbol%%

%%vat_rate%%

%%browser%%

%%browser_version%%

%%platform%%

%%is_tor%%

Geo Controller Tags vs. WordPress Shortcodes

Geo Controller supports both geographic tags and traditional WordPress shortcodes, but they are used differently.

Geo Controller Tags are placeholders designed for replacement inside supported HTML output:

%%country%%

WordPress Shortcodes are executed through the WordPress shortcode system:

[cfgeo return="country"]

Use geographic tags when you need to insert values directly into supported HTML content or attributes.

Use shortcodes when you need WordPress shortcode execution or additional functionality provided by a specific Geo Controller shortcode.

Geolocation Accuracy and Caching

Geo Controller uses IP-based geolocation to determine the visitor’s approximate geographic location.

Results can be affected by VPN services, proxy servers, mobile networks, corporate connections, and inaccuracies in geolocation databases.

Full-page caching and CDN services can also affect geographic content. If a page containing replaced geographic tags is cached, subsequent visitors may receive the geographic values stored in the cached HTML.

For websites displaying location-specific content, configure caching appropriately and test pages from multiple geographic locations.

Troubleshooting

A Geographic Tag Is Not Replaced

Check that the property name is supported and that Geo Controller is active.

Verify that the HTML output is processed by Geo Controller and that the geographic tag replacement functionality is enabled.

Some third-party plugins, page builders, AJAX responses, or cached HTML fragments may bypass the processing mechanism used for tag replacement.

A Geographic Tag Displays an Unexpected Value

Verify the visitor’s detected geographic information and review any active caching or CDN configuration.

IP-based geolocation is approximate and does not always identify a visitor’s physical location correctly.

Related Documentation

• Geo Controller Shortcodes
• PHP Integration
• JavaScript Integration

Summary: Geo Controller Tags provide a simple way to insert geographic information into supported WordPress HTML output. Use the available property list above to identify supported tags and include them in your content without writing custom PHP code.