Abstract. Incorporation of ions into the crystal structure of beryl (Be3Al2[Si6O18]) can take place by direct ion-to-ion substitution of the framework components Al3+, Be2+ and Si4+ or by occupation of interstitial or structural channel sites. The most common impurities in beryl include transition metals, alkalis and H2O. It is accepted that the transition metals Mn, Cr and V directly substitute for Al at the octahedral site and induce colour. Similarly, the octahedral site can host Fe instead of Al. Nevertheless, it is shown that it remains disputed whether Fe can also be present at the tetrahedral, interstitial, or channel sites, and opposing hypotheses exist regarding these possibilities. However, in the case of Fe, not only the possible occupation of these sites remains under debate, but also their influence on the subsequent colour of beryl. Similarly, the residence of Li in the channels and at the Be tetrahedral or interstitial tetrahedral sites is still under debate. The presence of more than two types of H2O (type I and type II) in the structural channels of beryl is also unclear. This article aims to give an overview on the consensus and on the current debates found in the literature regarding these aspects. It mainly concentrates on the substitution by and the role of Fe ions and on channel occupancy by H2O.