Getting Started
Install the ProRank Shopify app, grant scopes, enable the schema embed, and run your first audit.
ProRank for Shopify installs entirely from the Shopify App Store. You do not need to upload theme code or run a CLI on the merchant side. The app is embedded in the Shopify admin and uses the Admin API for everything it can edit directly.
Install in six steps
Install from the Shopify App Store
Search for ProRank SEO in the Shopify App Store and click Install. Shopify will redirect you to the app authorisation page.
Grant required OAuth scopes
Approve the access scopes Shopify lists. ProRank uses them to manage supported SEO fields, images, redirects, internal links, market-aware URLs, and storefront checks. Theme file writing is requested separately only when you choose a feature that needs it.
Land in the embedded admin
After install, ProRank opens inside the Shopify admin (Polaris UI). You will see the dashboard with audit, metadata, schema, images, internal links, IndexNow, and theme SEO tabs.
Enable the JSON-LD theme app embed
Open Online Store → Themes → Customize on your active theme → App embeds. Find "ProRank Schema JSON-LD" and toggle it ON, then Save. Without this step, no schema you save in the app will render in storefront HTML.
Run your first audit
Open the SEO Audit tab and click Run audit. The first scan can take a few minutes — it pages through supported products, collections, pages and articles via the Admin API and checks whether the public storefront is reachable. It does not crawl live HTML.
Review and fix
Audit results land on the dashboard. Fix detected metadata, content, merchandising, and image issues, then use ProRank’s separate tools for schema, internal links, redirects, and indexing.
App access
ProRank requests the required access scopes at install time. Each scope maps to a feature you can see in the app; optional access is requested separately when needed.
- read_products, write_products — product and collection SEO fields, content, and product media.
- read_content, write_content — pages, articles, and blog index SEO.
- read_files, write_files — the Files library, used by the optimise & replace, backup, and restore flows.
- read_markets — market-aware storefront domains and localized URL checks.
- read_online_store_navigation, write_online_store_navigation — URL redirects, navigation-aware workflows, and the IndexNow verification redirect.
- read_themes — read theme info (active theme detection, file listing for theme tools). Writing themes is gated behind a separate optional scope; see below.
Optional write_themes scope. Site-wide robots, collection noindex, image reference swaps, and customer auth redirect cleanups need the write_themes scope plus Shopify's protected-scope approval for theme file writes. It is declared as an optional scope and is granted in the app under Visibility → Theme SEO → Grant theme write access. Until the app owner releases it in an approved app version and the merchant approves the grant, theme-write actions return a scope error. See the Theme SEO Controls doc for the exact flow.
Enable the Schema JSON-LD app embed
ProRank stores generated schema as Shopify shop metafields. A theme app embed reads those metafields at storefront render time and injects them as JSON-LD into the page <head>. Until the embed is enabled on the active theme, no saved schema will render.
Online Store → Themes
→ Customize (on the active / live theme)
→ App embeds (in the left sidebar)
→ ProRank Schema JSON-LD
→ Toggle ON
→ SaveAfter a ProRank app update, the embed's UUID may change. If schema stops rendering unexpectedly, toggle the embed OFF, Save, then toggle it ON and Save again. This forces Shopify to pick up the current embed registration.
Pick a plan
Start on the $0 Free plan with 2 local audits, 10 managed AI requests, and 15 image optimizations per UTC calendar month. Eligible merchants can start a 3-day trial when they approve a paid plan in Shopify. Paid plans add cloud audits, automation, and higher managed-AI, audit, and image allowances.
Plans, exact pricing, and quotas are listed in Billing & Trial.
Run your first audit
- Open the SEO Audit tab.
- Click Run audit.
- Wait for the scan to finish. Supported findings are grouped by rule, including missing, short or long metadata; thin content; missing image alt text; oversized source images; missing product type or vendor; and storefront reachability problems.
- Drill into a rule group to see the affected rows.
- Use the relevant Metadata, Images, or Shopify editing workflow to resolve the finding.
Audits run when you start them. Re-run after a batch of fixes to confirm the result. Scheduled Autopilot scans are a separate paid automation feature; ProRank does not describe those scans as scheduled SEO audits.
Where to go next
SEO Metadata
Edit product / collection / page / article / blog index titles and meta descriptions with per-row AI Generate.
Read the Shopify metadata guide →Schema
How JSON-LD is generated, where it's injected from, and how to validate it on the live storefront.
Read the Shopify schema guide →