The CMS can generate several different types of data visualizations. These visualizations are maps and charts that the CMS creates with published data in the FDW and makes them interactive on the website.
Detailed guidance for building AFI and HFA maps for reports can be found below. For all other data visualizations, please reference tailored guidance in the Standard Visualizations section.
AFI and HFA Maps
Use the settings below to create AFI and HFA maps for reports.
If you need to edit the AFI or HFA map visualizations, you will notice the collection data field will go blank. Despite this, the information will remain captured. You can confirm this by viewing the date under the field box. It should reflect the date you originally input into this field.
Once you make changes, you must click the Generate the URL button again to actualize those changes.
AFI Map (with timeline)
Before building this data visualization, food security data must be uploaded and published in the FEWS NET Data Warehouse (FDW) or the maps will not generate. If the data is updated and republished in FDW, you may experience a delay in the data visualization updating. You can try viewing the visualization in an incognito window or another browser, and reach out to the Hub for assistance as needed.
-
Select the Add Data Visualization content button.
-
Internal Title: Set a title “AFI maps” for reference to help you identify the data visualization within the report builder. This title won’t show up on the report.
-
Alt Text: Provide alternative text summarizing the CS and projected AFI. Reference guidance on writing alt text here.
-
Show Figure Label: Skip (button is off by default and should appear gray).
-
Visualization type: Select Acute Food Insecurity Map from the drop-down menu. A bug in the site is causing the page to scroll down after you make a selection. Scroll up to ensure you’re not missing any fields.
-
Country: Select the appropriate option for a country report. Leave this bank for a regional report.
-
Geographic Group: Select the appropriate option for a regional report. Leave this bank for a country report.
-
Collection Date: Type in the first day of the reporting month as MM/01/YYYY (e.g., 09/01/2025 for a September KMU). The date must be set as the first day of the reporting month to ensure the map displays correct data.
-
Start Date: Skip (leave blank).
-
Select one or more scenarios: Skip to include all available scenarios (CS, ML1, and ML2) on the web-generated PDF as applicable to the report type.
-
Select static maps layout type: This field affects how the maps display on the web-generated PDF.
-
For all reports: Select Vertical from the drop-down menu.
-
-
Show HFA data: Skip.
-
Visualization title: Skip (automatically generated).
-
Disclaimer: Skip (automatically generated).
-
Source attribution: Skip (automatically generated)
-
Display logos: Skip. This determination is made automatically by the system.
-
Click the Generate URL button and wait for the URL to populate the AFI map.
-
Click on the URL and review to confirm the maps are accurate. You can also share the link with anyone who has access to the FDW to review.
-
Show full-width in PDF: Skip (used for HFA maps only)
-
Float Position: Leave as Right for all reports.
Single Scenario AFI Map
Use the same process and settings as the AFI map above except for the following:
-
Select a scenario: Select one scenario (Current Situation, Near Term Projection, or Medium Term Projection) as applicable to the report type.
-
For all FSOs: Select Current Situation when building this visualization for the current acute food insecurity outcomes section.
-
HFA Map
Use the same process and settings as the AFI map above except for the following:
Layout and HFA Settings
-
Select static maps layout type: Choose Grid.
-
Show HFA data: Check the box to display HFA data.
Full Width and Float Position Settings
-
Show full-width in PDF: Click to toggle on (button should appear green).
-
Float Position: Choose None.
Previous: Add Report Content
Next: Add Key Messages