How to Fix “Liquid Error: Could Not Find Asset, Snippet, or Section” in Shopify

Fix Radar

Difficulty: ★★☆☆☆ to ★★★★☆ Time to diagnose: 5–30 minutes

Usually caused by: deleted snippets, copied tutorial code, leftover app references, theme update merges, GitHub deployment misses, or JSON templates referencing a section that no longer exists.

Quick answer: A Shopify “could not find asset,” “missing snippet,” or “missing section” Liquid error means the theme is referencing a file that does not exist in the expected folder. Use the file and line number in the error, find the render, include, section reference, or asset call, then restore the missing file from a backup/fresh theme or remove the broken reference if it belongs to old code or an uninstalled app.

The real symptom

The storefront shows a visible Liquid error instead of the expected header, product form, icon, app widget, or section. Common examples include missing icon-caret, icon-cart-empty, product-schema, breadcrumb snippets, review widgets, and notify-me snippets.

Liquid error (sections/header line 515): Could not find asset snippets/icon-caret.liquid
Liquid error (sections/main-product line 2261): Could not find asset snippets/product-schema.liquid
Liquid error: Could not find asset snippets/icon-cart-empty.liquid

Why this happens

Liquid renders a theme by following file references. When a file says {% render 'icon-caret' %}, Shopify looks for snippets/icon-caret.liquid. If that file does not exist, Shopify cannot render the snippet. The same logic applies to section files, asset files, and legacy app references.

Likely causes

A snippet was deleted accidentally.
Code was copied from another theme that had different snippets.
An app was uninstalled but the theme still references its snippet.
A theme update or Git deployment omitted a file.
A JSON template references a section type that no longer exists.
The wrong folder was used: snippets, sections, and assets are not interchangeable.

Confirmed Community fix

Shopify Community answers to these errors are consistent: read the error, open the named file and line number, identify the missing snippet or asset, then restore the file or remove the broken reference. Older evergreen threads show deleted breadcrumb and app snippets. Newer threads show missing icon snippets and product-schema snippets after customizations or copied code.

Exact admin path

Duplicate first: Shopify admin → Online Store → Themes → three-dot menu on live theme → Duplicate.

Edit code: duplicated theme → three-dot menu → Edit code.

Find the referenced file: open the folder named in the error: Snippets for snippets/icon-caret.liquid, Sections for section files, and Assets for CSS, JS, SVG, or other asset files.

Find the broken reference: open the file and line number shown in the error, or search for the missing filename without .liquid.

Liquid mapping check

{% render 'icon-caret' %}
→ requires snippets/icon-caret.liquid

{% include 'snippet-breadcrumbs' %}
→ requires snippets/snippet-breadcrumbs.liquid

{{ 'theme.js' | asset_url | script_tag }}
→ requires assets/theme.js

{% section 'custom-hero' %}
→ requires sections/custom-hero.liquid

Do not include the .liquid extension inside render. Shopify adds that when it looks in the Snippets directory.

Fix path 1: restore the missing file

Restore the file when the reference is legitimate and the feature should exist. Good sources include a backup theme, a fresh copy of the same theme version, the original theme repository, the app’s current installation instructions, or Dawn when the missing file is a standard Dawn icon snippet and your theme was built from Dawn.

Fix path 2: remove the broken reference

Remove or comment out the reference when it belongs to code you no longer use, such as an old app snippet.

{% comment %}
  Removed legacy app snippet after uninstall.
  {% render 'product-notify-me' %}
{% endcomment %}

Fix path 3: replace the reference

Sometimes the theme has a similar file under a different name. For example, the theme may have icon-arrow-down but code references icon-caret. In that case, fix the reference to match the existing snippet rather than creating duplicate files.

Section-specific check

If the error involves a section, inspect both sections/the-section-name.liquid and the relevant templates/*.json file. A JSON template can still reference a section after the section file was deleted.

DevTools check

DevTools is not the primary tool because Liquid errors happen server-side before the final HTML reaches the browser. Use the Shopify code editor first. DevTools can help only after the page renders, to confirm whether an app widget, icon, or section remains missing visually.

Common misunderstanding

Do not hide the message with CSS. That leaves the broken render path in place. Also do not create an empty snippet just to silence the error unless you are certain the missing output is optional.

Before you edit code

Duplicate the live theme and export a copy if the store has a lot of custom code. If the issue started after installing or uninstalling an app, check the app’s instructions and Shopify app history before deleting code. If it started after a theme update, compare the old and new theme files.

Do not do this

Do not delete the entire section because one snippet is missing.
Do not create empty snippets without understanding the feature.
Do not remove app snippets still required by an installed app.
Do not edit the live theme first.
Do not ignore the file and line number in the error.

How to test the fix

Preview the duplicate theme.
Visit the exact page that showed the error.
Search the page for “Liquid error.”
Test the feature near the error: header menu, cart icon, product form, review widget, subscription block, or section.
Check mobile and desktop.
Only publish after the duplicate theme renders cleanly.