Skip to content
Latchkey

Matrix Expansion Limit - CI/CD Glossary Definition

The matrix expansion limit caps a single job matrix at 256 generated jobs per run.

A matrix expansion limit is the cap GitHub Actions places on how many jobs one strategy.matrix can generate; a matrix may not expand to more than 256 jobs per workflow run.

When the product of matrix dimensions (plus include entries) exceeds 256, the run fails validation, so large sweeps must be split across workflows or reduced with excludes.

Related guides

Run this faster and cheaper on Latchkey managed runners. Start free →