This page answers the most common questions and problems users encounter in the Livelihoods Explorer.
General questions
What is this platform for?
This platform is designed to help users explore HEA baseline data, compare livelihood conditions across wealth groups and locations, review threshold calculations, and interpret basket and expenditure assumptions.
It supports:
-
Searching by region, Livelihood Zone, or Wealth Group
-
Comparing Baseline conditions across scenarios
-
Reviewing Survival and Livelihood Protection Thresholds
-
Understanding basket composition and contribution to household needs
-
Reviewing visual and tabular outputs for decision-making
Where do I start?
If you are new to the system, we recommend starting with About the Livelihoods Explorer.
If you are looking for a specific metric or definition, use the glossary and Key Concepts pages before exploring results in detail.
If you are looking for more information on how the data is calculated, use the pages under Understanding the Data.
Do you have documentation on x topic?
If you are looking for a specific topic, the search function is a great place to start. If you can’t find documentation on a specific item, contact our help desk.
Can I view the platform or documentation in another language?
The platform is available natively in English, French, Spanish, and Portuguese. Documentation will soon be natively available in French.
Are there known limitations?
Yes. Common limitations include:
-
Some records are incomplete or partially missing
-
Percentage-based summaries may not reflect raw totals exactly
-
The system does not include outcome analysis
Always review the related help.fews.net page for the metric or feature before using the output for reporting or decision-making.
How can I include the Baselines that our organization has collected?
If your organization would like to contribute to this project, please submit a help ticket. Be sure to include the name of your organization and an overview of the Baselines you have available. Please do not submit Baselines that your organization did not conduct or does not own.
Can I extract this data for further analysis?
Yes, data can be extracted using the Livelihoods Explorer API. Learn more.
Common troubleshooting issues
My search or filter returns no results.
Try the following:
-
Remove one or more filters and reapply them gradually
-
Confirm the selected geography and baseline are valid
-
Check whether the selected data type is available for the selected year or baseline
-
Use broader filters first, then narrow down
-
Verify that the filters are not combining incompatible options
Common causes:
-
The selected region has no matching baseline data
-
The selected wealth group does not exist for that area
-
A page or view is scoped to a different baseline or dataset version
-
A filter is using a term that was renamed or updated
If the problem persists, check whether the pages have recently changed or whether a different version of the dataset is active.
A map or chart appears blank or is not loading correctly.
Common issues:
-
Selected geography has no data for that metric
-
A filter combination is not valid for the map layer
-
The map is being viewed against a baseline that has no spatial coverage
-
Browser or display settings are preventing some graphics from rendering correctly
-
Metadata or data layers are not available for the selected period
Try:
-
Refreshing the page
-
Clearing your browser cache
-
Testing a simpler geographic filter
-
Checking if the same data appears in the tabular view
If the map is blank but the table is populated, the issue may be with the map layer or a filter mismatch rather than the underlying dataset.
A table loads, but the numbers look wrong or inconsistent.
Review:
-
Baseline selection
-
Wealth group selection
-
Household size assumptions
-
Whether the view is displaying percentages, raw values, or transformed kcal equivalents
-
Whether the page is showing a numerator/denominator relationship rather than a full total
In many places the system converts expenditure into kcal equivalents using annual_kcals_cost. This means a value in one view may appear different from the same value in another view even when they are mathematically related.
Data quality and calculation questions
Why do I sometimes see values as zero, blank, or missing?
Missing and null values are not always errors. In many cases:
-
A value may genuinely be zero
-
A value may be undefined because the data does not apply to that record
-
A metric may be intentionally omitted when it is not relevant to the selected unit or category
For calculation-heavy views, missing percentage_kcals or expenditure values are treated as zero for basket allocation logic. This prevents the system from failing on partial or incomplete records while still preserving the meaning of the underlying calculation.
If a value appears unexpectedly blank:
-
Check whether the selected filter combination is valid
-
Confirm that the region/wealth group has data available
-
Check whether the selected view or metric is defined for the item you are looking at
-
Review the Null Values page for expected handling of missing data
Why do totals sometimes not add up to 100%?
This is often expected and can happen for several reasons:
-
Values are rounded for readability and to avoid the suggestion of false precision as the data is based on interviews with a sample of the population. The displayed number may be a little different from the full-precision value used in calculations, and rounded figures may not add up exactly to a rounded total. Small differences caused by rounding are expected and do not necessarily indicate an error.
-
Some values are expressed as percentages of household energy requirements, while others are shown as expenditure converted into kcal equivalents
-
Different baskets contribute to different parts of household need, not all to the same denominator
-
Some numbers represent allocated portions of a category rather than a full total
Why are percentages different across wealth groups?
Differences are often expected because:
-
household size differs by Wealth Group
-
consumption patterns differ by Wealth Group
-
the basket assumptions differ by Wealth Group
-
expenditure is scaled according to average household size
How are basket allocations calculated?
Learn more about Threshold and basket calculations.
Why is expenditure converted to kcal equivalents?
Expenditure cannot be directly compared across currencies or to kcal percentages without converting it to a common unit. The system converts expenditure into kcal equivalents using the baseline annual_kcals_cost and household-size adjustments. This makes expenditure comparable with calorie-based requirement values, allows the system to model baskets consistently, and allows for comparison across geographies.
How to report a bug or data issue
To report an issue or request support, submit a help ticket. When reporting an issue, include:
-
Page name or feature name
-
Exact filters used
-
Geography, baseline, and wealth group
-
Screenshot of the issue if possible
-
A description of the issue including expected value vs actual value
-
Your operating system and browser
A good bug report is specific enough that a team member can reproduce it quickly without asking for more context.