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 requests only what it needs: read/write SEO fields on products, collections, pages, articles, and blogs; read/write files for image optimisation; read theme info; manage app proxy and metafields for the JSON-LD app embed.
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 your products, collections, pages and articles via the Admin API and fetches representative templates from the live storefront.
Review and fix
Audit results land on the dashboard. You can fix metadata, schema, and image issues per-row, or in bulk. Theme-level fixes need write_themes and Shopify protected-scope approval.
Required scopes
ProRank requests these access scopes at install time. Every scope maps to a feature you can see in the app.
- read_products, write_products — product titles, SEO fields, and product media replacement.
- read_product_listings — read collection structure for collection-level SEO.
- read_content, write_content — pages, articles, and blog index SEO.
- read_files, write_files — the Files library, used by the optimise & replace flow for theme images.
- read_themes — read theme info (active theme detection, file listing for audit checks). 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
ProRank for Shopify uses standard Shopify app billing. A trial is available; usage limits (audit cycles, IndexNow submissions, bulk operations) are enforced per plan via the AuditUsageCycle and BillingGuard models.
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. Issues are grouped by rule (missing meta title, short meta description, missing alt text, noindex conflict, missing schema, oversized image, broken internal link target, etc.).
- Drill into a rule group to see the affected rows.
- Click Fix on a row to jump to the right tool (Metadata, Images, Schema, Internal Links).
The audit re-runs on a schedule via the scheduler container. You don't need to click Run audit again to keep results fresh — but you can if you just finished a batch of fixes and want immediate confirmation.
Where to go next
SEO Metadata
Edit product / collection / page / article / blog index titles and meta descriptions with per-row AI Generate.
Read more →Schema
How JSON-LD is generated, where it's injected from, and how to validate it on the live storefront.
Read more →