Abstract The stable isotopic composition of pedogenic carbonate forms in equilibrium with environmental parameters and, thus, records palaeoenvironmental signals. The aims of this study are to synthesize available data on the stable isotopic composition of Quaternary pedogenic carbonates in calcareous parent materials of Iran and to decipher paleoenvironmental implications of the isotopic data for the country. Isotopic composition and microfabric of pedogenic carbonates in 18 pedons in both gravelly (calcareous alluvium in central Iran) and non-gravelly deposits (calcareous loess in northeastern Iran) have been investigated. The results indicate that in limestone-derived soils of central Iran in situ weathering of calcareous pebbles is a major source of Ca for genesis of the carbonates, and carbonate features consist of micritic calcite crystals. In the loessic soils of northeastern Iran, pedogenic carbonates show a dominance of nodule morphology and are classified as orthic nodules. Microfabric analysis reveals that most of the carbonates have not been altered by diagenetic processes, especially the Holocene carbonates, and are suitable for isotopic study and palaeoreconstructions. In limestone-derived soils within the arid region of central Iran, the δ 18 O and the δ 13 C values of carbonates indicate their enrichment due to the effects of evaporative water loss, a decline in plant density and the entrance of atmospheric CO 2 into the soils. In semi-arid ecosystems of central and northeastern Iran, most of the Holocene carbonates have formed in equilibrium with the ambient environment and are suitable for palaeoenvironmental reconstructions. The combination of carbon and oxygen isotopic data demonstrates the dominant role of climate in determining the δ 13 C values of carbonates. There is a strong relationship between the δ 13 C values of carbonates and rainfall, and between O isotopes and aridity indices. Stable isotope patterns in Holocene soils appear to provide data for models that can then be used to interpret the many localities where Pleistocene-aged soils and associated carbonate exist.