{"id":20334,"library":"prettier-plugin-antlers","title":"Prettier Plugin for Antlers (Statamic)","description":"Prettier plugin for formatting Antlers templates used in Statamic CMS. Current stable version is 2.0.5, supporting Prettier 3 (peer dependency >=3). The plugin uses the same formatting engine as Antlers Toolbox. Key differentiators: specifically for Antlers syntax, not generic HTML/Latte. Older v1.x supports Prettier 2, v2.x requires Prettier 3. Installation may require explicit plugin path reference in .prettierrc to avoid module resolution errors.","status":"active","version":"2.0.5","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","Antlers","Statamic","format"],"install":[{"cmd":"npm install prettier-plugin-antlers","lang":"bash","label":"npm"},{"cmd":"yarn add prettier-plugin-antlers","lang":"bash","label":"yarn"},{"cmd":"pnpm add prettier-plugin-antlers","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency at version >=3 for v2.x, required","package":"prettier","optional":false}],"imports":[{"note":"This is a Prettier plugin, not a library to require directly. Use via .prettierrc config.","wrong":"Trying to import in code with `const plugin = require('prettier-plugin-antlers')`","symbol":"prettier-plugin-antlers","correct":"Add to `plugins` array in .prettierrc as 'prettier-plugin-antlers' or './node_modules/prettier-plugin-antlers/'"},{"note":"The parser identifier is exactly 'antlers'. Commonly mistaken as 'antlers.html' due to file extension.","wrong":"Using parser: 'antlers.html' or 'antlers-html'","symbol":"antlers parser","correct":"Use `parser: 'antlers'` in config or CLI"},{"note":"The plugin is designed for Prettier's plugin system, not for direct programmatic use. Prettier 3 resolves plugins automatically if named correctly.","wrong":"const plugin = require('prettier-plugin-antlers')","symbol":"require('prettier-plugin-antlers')","correct":"Do not require/import directly"}],"quickstart":{"code":"// .prettierrc\n{\n  \"plugins\": [\"prettier-plugin-antlers\"],\n  \"overrides\": [\n    {\n      \"files\": [\"*.antlers.html\"],\n      \"options\": {\n        \"parser\": \"antlers\"\n      }\n    }\n  ]\n}","lang":"json","description":"Minimal .prettierrc configuration to enable Antlers formatting with the plugin."},"warnings":[{"fix":"Update Prettier to version 3 or higher, or install @^1 for Prettier 2 support.","message":"Plugin v2 requires Prettier >=3. Installing @^2 with Prettier 2 will fail.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use full path './node_modules/prettier-plugin-antlers/' in plugins array.","message":"Prettier 2 may fail to resolve plugin with error 'Could not resolve module prettier-plugin-antlers' unless path is explicit.","severity":"gotcha","affected_versions":">=1.0.0 <2.0.0"},{"fix":"Add in VS Code settings.json: \"[antlers]\": {\"editor.defaultFormatter\": \"esbenp.prettier-vscode\"} and \"prettier.documentSelectors\": [\"**/*.antlers.html\"].","message":"VS Code users get 'No formatter for Antlers found' if editor setting not configured.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Install @tailwindcss/prettier-plugin-typography separately and add to plugins list.","message":"Plugin does not include Tailwind CSS Prettier plugin; multi-class formatting may not work without it.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"For Prettier 2, use path './node_modules/prettier-plugin-antlers/' in .prettierrc. For Prettier 3, ensure plugin is installed and plugins list includes 'prettier-plugin-antlers'.","cause":"Prettier 2 cannot find plugin via npm module resolution; or Prettier 3 misconfigured.","error":"Could not resolve module prettier-plugin-antlers"},{"fix":"Add VS Code settings: \"[antlers]\": {\"editor.defaultFormatter\": \"esbenp.prettier-vscode\"} and \"prettier.documentSelectors\": [\"**/*.antlers.html\"].","cause":"VS Code not configured to use Prettier for .antlers.html files.","error":"No formatter for 'Antlers' found"},{"fix":"Install correct Prettier version: for @^2, install prettier@^3; for @^1, install prettier@^2.","cause":"Missing peer dependency prettier, or version mismatch.","error":"Cannot find module 'prettier'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}