Zeolitic imidazolate frameworks are promising as high-capacity iodine adsorbents. Here the authors image the gaseous I2 adsorption on single ZIF-90 particles, clarifying the inter-particle heterogeneity in adsorption reactivity and performance improvement after introduction of linker defects.