This work studies a novel class of nonlinear multi-term fractional q-difference equations with nonlocal boundary conditions. To utilize the fixed-point tools, the given problem is transformed into an equivalent fixed-point problem. The Leray–Schauder alternative is used to demonstrate the existence of solutions to the considered problem, and Banach’s fixed-point theorem is used to establish the uniqueness of the solutions.