Porous crystals with well-defined active metal centers on the pore surface have high potential as heterogeneous metal catalysts. We have recently demonstrated that a porous molecular crystal, metal-macrocycle framework (MMF), catalyzes olefin migration reactions by photoactivation of its Pd II Cl 2 moieties exposed on the crystalline channel surface. Herein we report a mechanistic study of the photo-induced olefin migration reactions at the Pd II active centers of MMF. Several experiments, including a deuterium scrambling study, revealed that olefin migration is catalyzed via an alkyl mechanism by in situ generated PdÀ H species on the channel surface during photoirradiation. This proposed mechanism was further supported by DFT and ONIOM calculations.