MissingAsset

MissingAsset

Severity: error | Type: LiquidHtml

This check reports cases where an asset_url filter references a file that does not exist in the app/assets/ directory. Missing asset references will produce broken links or 404 errors in production.

The check only applies to static string asset names — it cannot verify dynamically constructed asset paths.

Examples

✗ Incorrect Code Example (Avoid using this):

<link rel="stylesheet" href="{{ 'nonexistent.css' | asset_url }}">
<script src="{{ 'missing-bundle.js' | asset_url }}"></script>

Neither nonexistent.css nor missing-bundle.js exists in app/assets/.

✓ Correct Code Example (Use this instead):

<link rel="stylesheet" href="{{ 'app.css' | asset_url }}">
<script src="{{ 'app.js' | asset_url }}" defer></script>

Configuration

The default configuration for this check:

MissingAsset:
  enabled: true
  severity: error

You can ignore specific missing assets using the ignore option:

MissingAsset:
  enabled: true
  ignore:
    - modules/legacy/**

Disabling This Check

Disabling this check is not recommended. If you reference assets from modules that are not available locally, use the ignore option instead.

Resources

• platformOS Assets
• Using Static Assets