cfn-lint
github.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What cfn-lint is
cfn-lint is a free, open-source tool for validating AWS CloudFormation YAML and JSON templates. It checks templates against resource provider schemas and applies additional validations, including checks for property values and best practices. It can process AWS Serverless Application Model templates by transforming them with AWS SAM before validation. The linter uses rules for specific checks and also supports user-defined rules. Users can configure it through command-line options, configuration files, or CloudFormation template metadata. Output formats include quiet, parseable, JSON, JUnit, pretty, and SARIF. The project documents installation with pip, Homebrew for macOS, or Docker, and supports Python 3.10 through 3.14. Listed integrations include Atom, Emacs, NeoVim/Vim, Sublime, Visual Studio Code, and IntelliJ IDEA, as well as a GitHub Action and pre-commit hook. The project describes validation of complex template values as best effort: it will not fail only because it cannot understand or translate a value. The repository identifies its license as MIT No Attribution.
Who it suits
cfn-lint suits developers and teams validating AWS CloudFormation templates, including AWS SAM templates. Its editor integrations, GitHub Action, and pre-commit hook also fit validation workflows that use those tools.
Good to know, and what to watch
- Checks templates against resource provider schemas.
- Supports AWS SAM templates.
- Users can define custom rules.
- Outputs include JSON, JUnit, and SARIF.
- Complex template value validation is best effort.
- Supports Python 3.10 through 3.14.
Plans
Every plan and pricecfn-lint
Open source
Getting started
- Open the cfn-lint project website
- Install with pip, Homebrew on macOS, or Docker
- Use Python 3.10 through 3.14 when installing with Python
- Run the linter against CloudFormation or AWS SAM templates
- Configure checks with command-line options, configuration files, or template metadata
- Connect an editor, GitHub Action, or pre-commit hook if needed
Limits to check
Validation of complex template values is best effort; cfn-lint does not fail solely because it cannot understand or translate one. The project lists no paid tier or trial requirement.
The verdict
cfn-lint offers configurable template checks, multiple output formats, and integrations for editors and development workflows. Keep its best-effort handling of complex values in mind when interpreting validation results.
Questions people ask
How much does cfn-lint cost?
It is free and open source. The listed plan is free under the MIT No Attribution license.
Which operating systems are supported?
The listed platforms are Linux, macOS, Windows, and self-hosted environments.
What templates can it validate?
It validates AWS CloudFormation YAML and JSON templates and supports AWS SAM templates through transformation.
Can I add my own checks?
Yes. cfn-lint supports user-defined custom rules in addition to its specific validation rules.
How can results be exported?
Supported formats include quiet, parseable, JSON, JUnit, pretty, and SARIF.
Does it integrate with development tools?
Integrations are listed for Atom, Emacs, NeoVim/Vim, Sublime, Visual Studio Code, IntelliJ IDEA, GitHub Actions, and pre-commit.
What the maker publishes
- Configuration
- Users can configure cfn-lint with command-line options, configuration files, and CloudFormation template metadata. source
- Installation
- The project documents installation with pip, Homebrew for macOS, or Docker. source
- Integrations
- The project lists editor integrations for Atom, Emacs, NeoVim/Vim, Sublime, Visual Studio Code, and IntelliJ IDEA, plus a GitHub Action and pre-commit hook. source
- License
- The repository identifies its license as MIT No Attribution, which grants use, copying, modification, distribution, sublicensing, and sale without restriction. source
- Output
- Supported output formats include quiet, parseable, JSON, JUnit, pretty, and SARIF. source
- Purpose
- cfn-lint validates AWS CloudFormation YAML and JSON templates against resource provider schemas and additional checks, including valid property values and best practices. source
- Rules
- The linter processes rules for specific checks and validations, and supports user-defined custom rules. source
- Runtime
- The project states that Python 3.10 through 3.14 are supported. source
- SAM support
- The linter supports AWS Serverless Application Model templates by transforming them with AWS SAM before processing. source
- Support
- The project invites users to join its Discord community to discuss cfn-lint and get help. source
- Validation caveat
- The project describes validation of complex template values as best effort and says it will not fail just because it cannot understand or translate them. source
- Who it serves
- The project describes cfn-lint as a tool for validating AWS CloudFormation templates. source
Checked against the maker's pages on 2 Oct 2026.