Section reference

Utility sections

Use utility sections for app blocks, custom Liquid, policy pages, password pages, search, predictive search, 404 recovery, and small content needs.

AppsCustom LiquidSystem pagesSearchPassword and policy pages

Utility sections are usually where support issues come from custom code, app behavior, missing Shopify data, or unclear system-page setup. Configure them conservatively and test the exact page state customers will see.

Key Settings To Decide First

Theme editor setting

app block placement

What this controls

Where an installed Shopify app renders its widget or block inside a page template.

When to change it

An app needs to render reviews, subscriptions, forms, upsells, or widgets.

Watch out

Dropping app blocks into random templates without checking mobile and load behavior.

Theme editor setting

custom Liquid field

What this controls

A code entry area for trusted Liquid, HTML, or app snippets.

When to change it

A trusted snippet is required.

Watch out

Using Custom Liquid for layouts that standard sections can build safely.

Theme editor setting

section spacing / color scheme

What this controls

Visual controls that help app or custom content match surrounding sections.

When to change it

App or custom content looks visually disconnected.

Watch out

Fixing app visual issues with unrelated global theme changes.

Theme editor setting

policy sidebar links

What this controls

Navigation links that help customers jump through long policy pages.

When to change it

Policy pages are long.

Watch out

Putting all legal/support content in one unstructured block.

Theme editor setting

password page message

What this controls

The pre-launch message customers see before entering the storefront password.

When to change it

A store is pre-launch or private.

Watch out

Leaving default password-page copy during previews.

Theme editor setting

search filters / sorting

What this controls

Controls that help customers narrow and reorder search results.

When to change it

Search results need narrowing.

Watch out

Expecting search filters to fix poor product titles or tags.

Theme editor setting

empty state copy

What this controls

The message and links shown when search or a missing page has no result.

When to change it

Search or 404 returns no useful result.

Watch out

Ending on a dead page with no recovery path.

Theme editor setting

preview/testing state

What this controls

The exact theme, template, page, product, collection, and app state being tested.

When to change it

An issue appears only in editor or only live.

Watch out

Debugging custom Liquid or apps without reproducing the same page context.

Safe Setup Rules

  • Prefer app blocks over custom Liquid when the app provides a supported block.
  • Keep custom Liquid snippets short, documented, and isolated to the page that needs them.
  • Test app/custom sections on mobile and in the Shopify editor preview.
  • Use utility pages to recover customers: search, collection links, contact, and policies.
  • Remove placeholder password, policy, and 404 content before launch.

Common mistakes

  • Using custom Liquid as a general layout tool instead of a last-resort integration surface.
  • Adding app blocks without checking mobile layout or page speed.
  • Leaving password, 404, search empty-state, or policy copy generic.
  • Expecting search results to improve without clean product titles, tags, and Search & Discovery setup.
  • Changing global settings to fix one app block instead of adjusting the app/section context.