What are YAML files in Shopify?

Data files in YAML format — a human-readable config format used in some Shopify theme config, build tooling, and CI/CD.

Does Shopify use YAML?

Shopify themes primarily use JSON; YAML appears in developer tooling, build configs, and CI/CD pipelines.

YAML vs JSON — which is better?

JSON is more common in Shopify; YAML is more readable and supports comments — use YAML for config, JSON for data.

How do I edit YAML files?

With a text editor — learn the indentation-based syntax, and use a linter to catch errors.

What are YAML files used for?

Configuration — build tools, CI/CD pipelines, deployment configs, and some theme tooling.

Glossary Term

Y

YAML Files

A human-readable data format — used in config, CI/CD, and some Shopify tooling.

Book A Consultation Back to Glossary

Key Takeaways
YAML Files are data files in YAML format.
YAML is human-readable — popular for configuration.
On Shopify, YAML appears in theme config, build tooling, and CI/CD.
It's less common than JSON in Shopify itself.
It's a developer and config tool.

Overview

YAML Files are data files in YAML (YAML Ain't Markup Language) — a human-readable format for configuration. On Shopify, YAML is used in some theme config, build tooling, and CI/CD pipelines. It's less common than JSON in Shopify but appears in developer tooling.

YAML is developer-friendly. Its indentation-based structure is easy to read and write — popular for config files. While Shopify themes use JSON for settings, YAML appears in build tools, deployment configs, and developer workflows around Shopify.

YAML files pair with JSON (JavaScript Object Notation) (the more common format), HTML templates (related theme files), and back-end settings (config concepts). They're a developer and config tool.

1

Why YAML Files Matter for Shopify Developers

1
Readable Config
YAML is easy to read and write — great for config files.
2
Developer Tooling
YAML is common in build tools, CI/CD, and deployment configs.
3
Theme Config
Some Shopify theme tooling uses YAML for config — developer-facing.
4
Comments
YAML supports comments — JSON doesn't — useful for documenting config.
5
Hierarchical
YAML's indentation-based structure handles complex, nested data.

2

Working with YAML Files

1
Learn the syntax
YAML uses indentation for structure — learn the syntax before editing.
2
Use a linter
Use a YAML linter — indentation errors are easy to make.
3
Comments help
Use comments to document config — YAML supports them.
4
Convert from JSON
Tools can convert between JSON and YAML — use what fits.
5
Don't edit live
Don't edit YAML config on a live store without testing — errors break things.