Documentation
The Geography screen shows where in the world your visitors are. Open it from
Audience β Geography.
Headline cards
- Countries β how many distinct countries you reached in the period.
- Top Country and Top Continent β your single biggest sources.
- Geo Coverage β the share of visits that resolved to a location, plus the
count that couldn't be resolved. Coverage depends on your geo source (see below).
Visitor World Map
A shaded world map β darker countries = more views. Hover any country for its
views and unique visitors, and use + / β to zoom.
Breakdown tables
Below the map, tables list your top countries, regions/subdivisions and
cities, each with views, visitors, sessions and average session duration. Sort
by any column.
Each row ends with a Visits β button that opens the Visits Log
filtered to that location β so "what are my German visitors actually reading?"
is one click, and the breadcrumb brings you back.
How location is detected
GreenOrb resolves each visit's location from a single source, in order of
preference:
- Cloudflare β when your Cloudflare plan supplies city-level headers
(country and city, real-time, no setup). - A local database β MaxMind GeoLite2 City if you've supplied it, otherwise
DB-IP Lite (free, no account or API key required). - Cloudflare country-only β on the free Cloudflare plan with no local
database, the country is still recorded; no city is claimed.
Country and city always come from the same lookup β never one source's country
with another source's city β so a visit can never display a city that contradicts
its country flag. (Geo databases genuinely disagree about VPN and datacenter IPs,
which is why mixing sources is unsafe.)
The local database is not downloaded automatically. You choose it in the
setup wizard, or press the download button under
Settings & Privacy β Geography β until then nothing is
fetched and no request leaves your server. Keeping it current is a separate
opt-in, also off by default.
If no source is active, location stays unresolved (which is why Geo Coverage may
be below 100%). Configure this under Settings & Privacy β Geography.
A privacy note
City-level detection is more identifying than country-only. On a low-traffic site,
a city plus a timestamp can make an individual visitor recognisable, so GreenOrb treats
analytics as pseudonymous, not anonymous, and lets you dial geography back to
country-only if you prefer. See Understanding your metrics.
Next: Devices β