Trihalomethanes (THMs) and haloacetonitriles (HANs), most common disinfection by-products in drinking water, pose adverse environmental impacts and potential risks to human health. There is a pressing need to develop innovative, economically feasible, and environmentally benign processes to control these persistent contaminants. In this paper, visible-light-responsive graphitic carbon nitride (g-C3N4) samples were synthesized to degrade the THMs and HANs and the photocatalytic degradation mechanism was explored. The results indicated that a carbon-doped g-C3N4 with an optimum dopant content (MCB0.07) displayed the best photocatalytic activity for the total trihalomethanes (TTHM) and total haloacetonitriles (THAN), with the reaction rate constant of 11.6 and 10.4 (10−3 min−1), respectively. MCB0.07 demonstrated a high THMs and HANs removal efficiency under visible light irradiation and could be reused. According to scavenger tests of the selected reactive species and X-ray photoelectron spectroscopy, holes play a dominant role for both THMs and HANs degradation on the MCB0.07. The degradation of HANs by holes proceeded mainly through breakage of the CC bond in the CCN group. The THMs degradation was achieved through hydrogen abstraction or/and dehalogenation. The brominated-THMs/HANs were more photosensitive than their chlorinated analogous and were less stable than bromo-chloro-THMs/HANs. This study sheds light on the mechanism of the photocatalytic degradation of THMs and HANs under visible light irradiation by carbon-doped g-C3N4. Furthermore, it could provide insights for engineering applications and contaminant control in drinking water purification. Display omitted •A carbon-doped g-C3N4 displayed high photocatalytic activity for TTHM and THAN.•Holes played dominant roles for THMs and HANs degradation.•THMs degradation was achieved through hydrogen abstraction or/and dehalogenation.•The photocatalysis removed HANs mainly through CC bond breakage.