docs: Add example for using null in values files to override parent chart defaults

[promptless-for-oss]

Open this suggestion in Promptless to view citations and reasoning process

Documents how to use null values in override files passed via -f/--values to remove parent chart defaults for subcharts. The existing "Deleting a default key" section only showed the --set approach; this adds a complementary values file example.

Trigger Events

helm/helm PR #31946: fix: allow null values from --values to override parent chart values

Promptless Research (7 files, 1 GitHub PR)

• Reviewed helm/helm#31946
• Viewed .long_term_context/product_knowledge/product_overview.md
• Viewed .long_term_context/doc_workflow/client_instructions.md
• Viewed .long_term_context/style/client_style_guide.md
• Viewed docs/chart_template_guide/subcharts_and_globals.md
• Viewed docs/chart_template_guide/values_files.mdx
• Viewed versioned_docs/version-3/chart_template_guide/values_files.mdx
• Viewed versioned_docs/version-3/chart_template_guide/values_files.md

Agent Response

I've reviewed the PR and created a documentation suggestion.

Summary

PR reviewed: helm/helm#31946 - fix: allow null values from --values to override parent chart values

This bug fix restores the ability for null values in override files (passed via -f/--values) to remove parent chart defaults for subcharts—behavior that was expected since Helm 3.17.0.

Documentation Update

The existing documentation in the "Deleting a default key" section of the Values Files guide only showed how to use null with the --set flag. I've added a complementary example showing the same technique using a values file, which is the exact use case this bug fix addresses.

Files updated:

• docs/chart_template_guide/values_files.mdx (current docs)
• versioned_docs/version-3/chart_template_guide/values_files.md (v3 docs)

New content added:

# override-values.yaml
mysubchart:
  unwantedKey: null

helm install myrelease ./mychart -f override-values.yaml

This helps users understand they can use null in values files to remove subchart defaults, not just via --set.

---

Tip: Sort by Shortest Review in the Dashboard to find quick wins ⚡

[promptless-for-oss]

Citation: Bug fix PR for null values in --values files. The fix in pkg/chart/common/util/coalesce.go restores the ability for null in override files to remove parent chart defaults, which was the expected behavior since Helm 3.17.0.
View source