CircleCI "resource_class requires a paid plan"
Larger resource classes (more CPU/RAM, GPU, arm) require a paid plan. Requesting one your plan does not include fails the job before it runs.
What this error means
The job fails immediately, stating the requested resource_class is not available on your plan or requires an upgrade.
circleci
resource_class large is not available on your plan.
Upgrade to a paid plan to use larger resource classes.Common causes
Requested class above plan tier
The chosen resource_class is gated behind a higher plan.
Special classes need entitlement
GPU, arm, or very large classes require specific plan entitlements.
How to fix it
Use an available class or upgrade
Select a resource class included in your plan, or upgrade to unlock larger ones.
.circleci/config.yml
jobs:
build:
docker:
- image: cimg/node:20.11
resource_class: medium # included on most plans
steps:
- run: npm testHow to prevent it
- Pick resource classes available on your plan.
- Upgrade deliberately when larger classes are needed.
- Document which jobs require paid resource tiers.
Frequently asked questions
What causes ""resource_class" plan"?
The chosen resource_class is gated behind a higher plan.
How do I fix "resource_class" plan?
Select a resource class included in your plan, or upgrade to unlock larger ones.
Related guides
CircleCI "Too many concurrent runs" - Plan Concurrency LimitFix CircleCI too many concurrent runs - the plan concurrency limit is reached, so new jobs queue until runnin…
CircleCI Machine Executor Image Not FoundFix CircleCI machine executor image not found - an invalid, deprecated, or removed machine image tag, or a tr…
CircleCI Cannot Use Environment Variable in Image NameFix CircleCI image name interpolation failures - shell environment variables do not expand in the docker imag…