Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

cfn-lint

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.4 Club score Visit github.com

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.

cfn-lint

Free

Open source

Getting started

  1. Open the cfn-lint project website
  2. Install with pip, Homebrew on macOS, or Docker
  3. Use Python 3.10 through 3.14 when installing with Python
  4. Run the linter against CloudFormation or AWS SAM templates
  5. Configure checks with command-line options, configuration files, or template metadata
  6. 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.