World Chaos Map Docs
Loading...
Open map

Frequently Asked Questions

Quick answers to common questions about World Chaos Map.

What is World Chaos Map?

A real-time visualization of global instability. Each country gets a 0–100 pressure score based on aggregated incident signals (conflicts, disasters, protests, cyber attacks, etc.). The map uses color bands to show which regions are under stress.

What does the score mean?

The score represents "pressure" — an abstract measure of instability signals. It's not a prediction or safety index. Higher scores mean more recent activity detected.

0–29 Stable 30–59 Moderate 60–84 Unstable 85–100 Severe
How often does it update?

Every 4 hours, so new events usually appear within a few hours. Scores rise straight away when something serious is reported and come down gradually, over days, as things calm down.

Where is the data from?

Structured APIs (USGS, GDACS, ReliefWeb, WHO, GDELT, UCDP) plus curated RSS feeds from major news outlets, humanitarian orgs, and conflict monitors.

View all sources →
How accurate is it?

The system detects signals, not ground truth. High-profile conflicts are well-tracked; localized civil unrest may lag. Accuracy varies by country based on source coverage.

Why is event X not reflected?

Possible reasons:

  • Event not yet in our feeds
  • Duplicate detection merged it with similar incident
  • Keywords triggered demotion (sports, anniversaries)

Note: Scores go up immediately, but come down gradually so a country does not look calm the moment the headlines move on.

What is the world chaos score?

One number for the whole planet: every country's score weighted by population, so it reflects the chaos level the average person lives in. It uses the same 0-100 bands as countries. See how it is calculated.

How do I share a country or the world score?

Tap Share on the Today panel or on any country. You get a story-sized card (dark or light) you can post straight to Instagram Stories, save, or copy as a transparent sticker. Every card links back to that country on the map.

What is the dotted map?

An optional style that draws countries as dots in their chaos colour, like the share cards. Turn it on from the layers button (top right). Zoom in and the normal country shapes fade back in. Your choice is remembered on that device.

Can I use this commercially?

The scores are free to use with credit for non-commercial work under CC BY-NC 4.0 (see License). For commercial use, data exports or white-label licensing, contact shaw@worldchaosmap.app.

Is there a public API?

Not yet. A read-only API for scores and incidents is planned. Check back on the Changelog for updates.

How does it read the news?

Every story is read automatically to find what happened (deaths, attacks, riots, curfews), where it happened, and whether it is a real event or just commentary, history or diplomacy. Opinion pieces and statements count for very little even when they use alarming words. See what counts.

Does it handle non-English news?

Yes. Sources cover every region in many languages, and global event data adds coverage in more than 100 languages. The same event reported in different languages is counted once.

How do you know which sources are reliable?

Every source builds a track record: how reliably it loads, how often it reports real events, and whether it reports first-hand or repeats others. New sources start in the middle and earn their place; unreliable ones count for less automatically.

Have more questions?

Reach out directly or browse the methodology.