The present work introduces a matrix analogue of a general class of q-polynomials \(\{ S_{n}(A,L,m;x|q): A\in \mathbb {C}^{r\times r}, L\in \{0\}\cup \mathbb {N}, m\in \mathbb {N}, x\in \mathbb {R}, 0<q<1 \}\) . For these polynomials certain properties such as the inverse series relation, integral representations and q-difference equation are obtained. The particular cases namely, the q-Brafman matrix polynomials, q-Konhauser matrix polynomials, an extension of q-Laguerre matrix polynomials, q-extended biorthogonal matrix polynomials and extended q-Jacobi matrix polynomials are also illustrated.