OrphanedPartial

Last edit: Apr 01, 2026

OrphanedPartial

Severity: warning | Type: LiquidHtml

This check exists to prevent orphaned partials in platformOS applications. A partial is considered orphaned when it is not referenced by any other file — no {% render %}, {% function %}, {% include %}, or {% graphql %} tag points to it.

Orphaned partials are dead code: they increase maintenance burden, can cause confusion, and bloat the codebase. This check helps you identify and remove them.

Examples

✗ Incorrect Code Example (Avoid using this):

app/views/partials/old-promotional-banner.liquid

This partial exists in the file system but is never referenced by any other template.

✓ Correct Code Example (Use this instead):

Either delete the orphaned partial, or add a reference to it from another template:


{% render 'old-promotional-banner' %}

Configuration

The default configuration for this check:

OrphanedPartial:
  enabled: true
  severity: warning

Disabling This Check

This check can be disabled for projects that have partials intentionally kept for future use. You can also use the ignore option to exclude specific paths:

OrphanedPartial:
  ignore:
    - modules/legacy/**

OrphanedPartial