RankEngineRankEngine Help

Theme app embed — toggle on but nothing renders on storefront

If you've enabled "RankEngine SEO" in your theme's App Embeds but the storefront source doesn't show our markers (<!-- RankEngine Speed -->, JSON-LD scripts), here's the fix.

What "enabled" means

A theme app embed is a Shopify-managed block injected into your theme's <head> (or other targets). For our embed to render, two things must be true:

  1. Toggle ON — Shopify Admin → Online Store → Themes → Customize → App Embeds → "RankEngine SEO" must be on.
  2. Saved — you MUST click "Save" in the customizer. Without saving, the toggle state lives only in the customizer preview, not in the published theme.

Common cause

Toggling on without saving. Looks "enabled" in the customizer because the preview reflects unsaved state. Doesn't render on the live storefront because config/settings_data.json was never updated.

How to fix

  1. Open the customizer.
  2. Confirm "RankEngine SEO" is toggled on.
  3. Click "Save" (top right).
  4. Visit your storefront.
  5. View page source. Search for <!-- RankEngine Speed -->. Should be present in <head>.

What about extension version updates?

When RankEngine ships a new version of the theme app extension, existing installs need to pull the new version manually:

  1. Shopify Admin → Apps → RankEngine SEO AEO → "Update available" notification.
  2. Click "Update".
  3. Re-open the theme customizer. The toggle stays in its previous state, but the underlying code is the new version.

Verifying via storefront source

Right-click → View page source → search for:

  • RankEngine Speed — speed optimizations
  • application/ld+json with RankEngine Schema markers — structured data
  • RankEngine Canonical — canonical URLs
  • RankEngine LocalBusiness — local schema (if enabled)

If any are missing despite the toggle being on + saved, the extension version may be stale. Update via the Apps menu.

Related