← Docs·Integrations

Installing the Shopify app

One-click install from the Shopify App Store, scoped to theme edits and metafields.

2 min read

title: "Installing the Shopify app" slug: "shopify-install" description: "One-click install from the Shopify App Store, scoped to theme edits and metafields." group: "Integrations" order: 11

The AIRRNK Shopify app makes your store easier to cite by AI answer engines. It ships llms.txt, injects Product / FAQPage / Review schema, and flags chunk-hostile content patterns on your product pages.

Install from the App Store

  1. Open apps.shopify.com/airrnk.
  2. Click Add app and authorize.
  3. On the install screen you'll approve two scopes: read_themes / write_themes (for schema injection) and read_products / write_products (for product-level metafield updates).
  4. After redirect, paste the site token from your AIRRNK dashboard. Save.

You're connected. First sync runs within sixty seconds.

What the app does

On first connect, the app:

  • Deploys a llms.txt route via an App Proxy at /apps/airrnk/llms.txt and a canonical redirect from /llms.txt so it's reachable at the root.
  • Adds a theme snippet — snippets/airrnk-schema.liquid — rendered inside your theme's <head> via a content_for_header hook. This is the only theme edit it makes.
  • Reads product metadata to generate Product + Review + AggregateRating JSON-LD, auto-filled from your existing Shopify data.
  • Registers a webhook for products/update so schema stays fresh when you edit inventory.

No pages are auto-modified. The app proposes fixes in your AIRRNK dashboard; you approve or skip each one.

Theme compatibility

Works on all Online Store 2.0 themes (Dawn, Craft, Sense, Refresh, Studio, Colorblock, and every popular third-party theme from the Shopify Theme Store). Vintage (pre-2.0) themes are best-effort — schema injection works, but the admin UI for editing injection points is disabled.

Scope & data access

The app reads product data, theme files, and metafields. It does not read customer data, orders, financials, or checkout information. Full scope list:

  • read_themes, write_themes (theme snippet install + schema injection)
  • read_products, write_products (metafield writes for schema caching)
  • read_content (blog posts, for content-readability scoring)

All write actions are logged in the app's Activity tab with timestamps and diffs.

Uninstall

From Shopify admin → Apps → AIRRNK → Uninstall. Shopify automatically revokes all tokens. The theme snippet and App Proxy are torn down. Schema and metafields written by the app remain — they don't break anything, but you can remove them manually if you want a clean uninstall.

Troubleshooting

"Theme snippet couldn't be written." Your theme file permissions may be locked by a theme customization tool (e.g. Shogun). Disable write-lock on the theme, reinstall.

Schema appears twice. A competing SEO app is also injecting Product JSON-LD. Use the Defer schema injection toggle in the app's Settings, and disable the other app's schema module.

llms.txt not resolving. Shopify caches App Proxy routes aggressively. Give it five minutes on first deploy, then hit /llms.txt?nocache=1 to force-bust.

Next