Helm "values don't meet the specifications of the schema(s)" in CI

The chart ships a values.schema.json and Helm validated your merged values against it. One or more values are the wrong type, out of range, or missing a required field, and Helm lists each violation.

What this error means

helm install/template/lint fails with "Error: values don't meet the specifications of the schema(s) in the following chart(s):" followed by JSON Schema messages.

Error: values don't meet the specifications of the schema(s) in the following chart(s):
my-app:
- replicaCount: Invalid type. Expected: integer, given: string
- image.tag: image.tag is required

Common causes

A value has the wrong type

A --set replicaCount=2 may arrive as a string where the schema expects an integer; use --set replicaCount=2 only where coercion applies, or --set-json.

A required value is missing

The schema marks a field required and it was not set in any loaded values file or override.

How to fix it

Correct the value to match the schema

Read each listed violation and fix the type or supply the required field, using --set-json for typed values.

helm upgrade --install my-app ./chart \
  --set-json replicaCount=2 --set image.tag=1.4.2

Validate values before deploy

1. Run helm lint with your values to surface schema violations.
2. Fix each reported field.
3. Re-render with helm template to confirm validation passes.

helm lint ./chart -f values-prod.yaml

How to prevent it

• Keep environment values files in sync with values.schema.json.
• Use --set-json so numbers and booleans keep their types.
• Run helm lint -f <values> in CI before deploying.

Related guides