Purine alkaloids are naturally occurring nitrogenous methylated derivatives of purine nucleotide degradation products, having essential roles in medicine, food and various other aspects of our daily lives. They are generated through convergent evolution in different plant species. The pivotal reaction steps within the purine alkaloid metabolic pathways have been largely elucidated, and the convergent evolution of purine alkaloids has been substantiated through bioinformatic, biochemical and other research perspectives within -adenosyl-ʟ-methionine-dependent -methyltransferases. Currently, the biological and ecological roles of purine alkaloids, further refinement of the purine alkaloid metabolic pathways and the investigation of purine alkaloid adaptive evolutionary mechanisms continue to attract widespread research interest. The exploration of the purine alkaloid metabolic pathways also enhances our comprehension of the biochemical mechanism, providing insights into inter-species interactions and adaptive evolution and offering potential value in drug development and agricultural applications. Here, we review the progress of research in the distribution, metabolic pathway elucidation and regulation, evolutionary mechanism and ecological roles of purine alkaloids in plants. The opportunities and challenges involved in elucidating the biochemical basis and evolutionary mechanisms of the purine alkaloid metabolic pathways, as well as other research aspects, are also discussed. This article is part of the theme issue 'The evolution of plant meta-bolism'.