---
title: "How to Display Reviewer Country Flags & Geolocation in ReviewX"
description: Show a country flag alongside each review to add authenticity for international stores.
url: "https://reviewx.io/docs/how-to-display-the-reviewers-country-with-their-review/"
updated: "2026-09-29"
category: FAQ
---

# How to Display Reviewer Country Flags & Geolocation in ReviewX

In modern cross-border eCommerce, showing *where* your customers are located provides invaluable geographic social proof. Displaying small country flags alongside reviewer names signals to prospective buyers that your store is globally trusted and actively ships to their region. An international customer browsing from Canada, the UK, or Germany feels significantly more confident placing an order when they see verified reviews from fellow shoppers in their own country.

ReviewX includes a built-in, privacy-respecting geolocation system that automatically resolves and displays reviewer country flags. This guide explains how ReviewX determines country locations, how to enable country display, and how to style the flags in your storefront.

---

## 1. How ReviewX Geolocation Architecture Works (Privacy-First)

ReviewX resolves reviewer country on the shop's own server using the dedicated utility `app/Utilities/Geo.php`. Unlike third-party scripts that track visitors across the web, ReviewX implements a strict, privacy-first data hierarchy:

1. **Order Billing / Shipping Address (Highest Priority):** For verified purchases, ReviewX inspects the actual country selected during checkout (`$order->get_billing_country() ?: $order->get_shipping_country()`). Stated checkout data beats any IP inference.
2. **Registered Customer Profile:** For registered users leaving reviews, ReviewX reads their saved user meta billing country (`billing_country`).
3. **WooCommerce Analytics Guest Lookup:** For guest shoppers, ReviewX looks up previous customer records in the database table (`{$wpdb->prefix}wc_customer_lookup`).
4. **Server & CDN Country Headers:** During live frontend submissions, ReviewX checks trusted reverse-proxy headers (such as Cloudflare's `CF-IPCountry` or WooCommerce MaxMind GeoIP).
5. **Developer Filter Hook:** Developers can override the detected country programmatically using the `reviewx_reviewer_country` filter.

  **Zero Privacy Leakage:** Reviewer IP addresses never leave your WordPress server. Only the standardized two-letter ISO country code (e.g. `US`, `GB`, `CA`, `DE`) travels to the database and sync services.

---

## 2. Step-by-Step: Enabling Reviewer Country Display

To display country flags next to customer reviews across your store:

1. Navigate to **ReviewX → Reviews** in your WordPress dashboard.
2. Click the **Review settings** button in the top navigation bar.
3. Locate the row labeled **Display reviewer country with review**.
4. Toggle the switch to the **ON** position.
5. Optionally review adjacent privacy settings:
   - **Show reviewer name:** Controls whether the customer's full name is published.
   - **Censor reviewer name:** Masks letters (e.g., *J*** D***) for shoppers who prefer partial anonymity.
6. Click **Save** to apply your configuration.

![ReviewX Reviewer Country Flag and Name Display Settings](https://reviewx.io/wp-content/uploads/2026/09/rvx_reviewer_country_settings_annotated.png)

  **Interface Callout Highlights:**
 **(1) Display Reviewer Country with Review:** Enables country flag icon rendering next to the author header.
 **(2) Censor Reviewer Name:** Privacy masking feature for reviewer names.
 **(3) Show Reviewer Name:** Master toggle for customer name visibility.

---

## 3. Storefront Display & Live Customizer Styling

Once enabled, ReviewX renders a crisp vector flag icon and country label next to the reviewer's name and verified badge in all review cards:

![ReviewX Storefront Review Card with Country Flag and Verification](https://reviewx.io/wp-content/uploads/2026/09/storefront_country_flag_annotated.png)

  **Storefront Review Card Highlights:**
 **(1) Author Header & Flag:** Reviewer name accompanied by their country flag badge.
 **(2) Star Rating & Multi-Criteria:** Star rating breakdown and criteria scores.
 **(3) Verified Purchase Badge & Body:** Authenticated buyer badge, review title, and detailed feedback.

To adjust flag positioning, border radius, or badge margins, navigate to **Appearance → Customize → ReviewX → Review List** in the WordPress Live Customizer.

---

## 4. Developer Filter Hook: Overriding Country Codes

If you have a custom IP-lookup service or need to sanitize country codes for staging environments, use the built-in filter:

```php
/**
 * Filter Reviewer Country Code in ReviewX
 *
 * @param string|null $code Two-letter ISO country code (e.g. 'US', 'GB')
 * @param string|null $ip   Visitor IP address
 * @param array       $ctx  Context array (order_id, user_id, email)
 * @return string|null
 */
add_filter( 'reviewx_reviewer_country', function( $code, $ip, $ctx ) {
    // Custom fallback or geolocation override
    if ( empty( $code ) && ! empty( $ctx['order_id'] ) ) {
        $order = wc_get_order( $ctx['order_id'] );
        if ( $order ) {
            return $order->get_billing_country();
        }
    }
    return $code;
}, 10, 3 );
```

---

## Related Articles

- [How to Show Verified Purchaser Badges in ReviewX](https://reviewx.io/docs/verified-badge/)
- [How to Censor or Hide Reviewer Names for Privacy](https://reviewx.io/docs/how-to-hide-reviewers-name/)
- [How to Design the Review List Using WordPress Live Customizer](https://reviewx.io/docs/how-to-design-review-list-using-wordpress-live-customizer/)
- [How to Moderate and Manage All WooCommerce Reviews](https://reviewx.io/docs/how-to-manage-all-woocommerce-reviews/)