YAML Tools
GitLab CI Linter
Validate .gitlab-ci.yml files for common structural errors.
Loading tool…
What is GitLab CI?
A linter for GitLab CI files: it verifies jobs are mappings, each has a script (or trigger/include), and the file parses cleanly.
How it works
The YAML is parsed and every top-level key that isn't reserved (stages, variables, default…) is treated as a job and checked for script/trigger/include.
- Enter your input. Type or paste your input into the field above — the tool responds instantly.
- Review the result. Output updates live as you type. Everything runs entirely in your browser.
- Copy or download. Use the Copy button to grab the result, or Download to save it as a file.
Examples
Pipeline sanity check
Lint a .gitlab-ci.yml for valid job structure, stage references, and keyword typos before a pipeline run.
Common mistakes
Stages referenced but not defined
Jobs pointing at undeclared stages fail at pipeline creation. The linter cross-checks every stage reference.
Frequently asked questions
Does it understand GitLab-specific keywords?
Yes — include, rules, needs, and the standard job keywords are recognized.
Can it validate include files?
Local includes are checked for existence; remote includes are validated by shape only.