MissingPartial
MissingPartial
Severity: error | Type: LiquidHtml
This check ensures that resources specified with the {% render %} tag, {% function %} tag, {% graphql %} tag, and the deprecated {% include %} tag actually exist in your project. It aims to prevent Liquid rendering errors caused by referencing non-existent files.
Examples
✗ Incorrect Code Example (Avoid using this):
{% render 'partial-that-does-not-exist' %}
{% function result = 'lib/function-that-does-not-exist' %}
{% graphql g = 'graphql/query-that-does-not-exist' %}
✓ Correct Code Example (Use this instead):
{% render 'shared/header' %}
{% function result = 'lib/my_function' %}
{% graphql g = 'records/search' %}
Configuration
The default configuration for this check:
MissingPartial:
enabled: true
severity: error
ignore_missing
Specify a list of patterns for missing files to ignore. Unlike the global ignore option (which ignores offenses based on the file containing the tag), ignore_missing ignores offenses based on the target file being referenced.
MissingPartial:
ignore_missing:
- icon-*
- modules/private-module/**
This configuration ignores offenses for {% render 'icon-missing' %} across all app files.
MissingPartial:
ignore:
- modules/private-module/index.liquid
This configuration ignores all MissingPartial offenses in modules/private-module/index.liquid, regardless of the target file.
Disabling This Check
Use the ignore_missing option to suppress false positives for private modules or generated partials instead of disabling the check entirely.