Help

Getting started

How do I run my first scan? Open the app from your Shopify admin and click Run scan on the dashboard. A scan walks your products (plus collections, pages and blog articles on Growth and above) and checks each one against 13 SEO rules: missing or duplicate meta titles and descriptions, missing image alt text, missing structured data, broken links, and a few others. It runs in the background, so you can close the tab and come back to it.

What does the score mean? Every resource starts at 100 and loses points for each open issue, more for a missing meta title than for a description that's a few characters too long. The store score is the average across everything scanned. Fixing an issue or dismissing it as not relevant both remove its weight from the score; dismissing doesn't touch your store, it just tells the app you've decided that particular finding doesn't apply.

Do scans change anything automatically? No. A scan only reads your store and records what it finds. Nothing is written back until you generate a fix and then explicitly apply it, or, on Growth and Pro, until you turn on automatic rescans and auto-fix for newly added products in Settings.

AI fixes

What counts as one AI fix? One OpenAI call per resource, not per issue. If a product is missing its meta title, meta description, and alt text on three images, fixing all of that in one generate action still costs one AI fix from your monthly allowance.

What happens when I run out? Every plan's AI fix allowance is a hard limit (free is 25 fixes total and they don't reset), and each paid plan's allowance renews every billing period. Once you're at the limit, generating new fixes pauses with a plain message telling you so; nothing bills automatically, and upgrading raises the allowance immediately. Anything already generated or applied before you hit the limit stays exactly where it is.

Can I use my own OpenAI key? Yes, in Settings. Your key is encrypted before it's stored and only a masked hint (like sk-…a1B2) is ever shown back to you. The app can use it to generate fixes, but nobody can read it back out through the UI. Using your own key means your OpenAI usage bills to your own account instead of counting against the app's shared allowance.

Why does a fix sometimes get rejected or need a retry? The app enforces length limits on generated meta titles and descriptions in code after the AI responds, because a model asked for "50–60 characters" doesn't always deliver exactly that. If a response comes back too long or too short, it's regenerated rather than applied as-is, and you're never charged twice for that internal retry.

Plans and billing

How do I upgrade or downgrade? From the Billing page inside the app. Shopify hosts the actual plan-selection screen and handles the charge. The app never sees your card details, and your invoice comes from Shopify, not from us directly.

What happens to my data if I downgrade? Nothing is deleted. Issues already found, fixes already applied, and any history the app has collected (Search Console figures, keyword rankings, report history) all stay. You simply lose access to the features above your new plan. For example, downgrading from Growth to Starter turns off Search Console and AI content rewriting, but the SEO fixes already written to your store remain.

Is there a free trial? Every paid plan includes a trial. It's a single window per store: it starts the first time you subscribe to any paid plan, upgrading mid-trial carries the remaining days across to the new plan, and cancelling and re-subscribing later does not start a new one.

What if I exceed my plan's AI fix allowance? The allowance is a hard ceiling on every plan, including paid ones. It is not a metered rate that bills extra usage. Generation pauses at the limit until the period renews or you upgrade.

Google Search Console

What does connecting Search Console do? It lets the app read your store's own click, impression and average-position figures directly from Google (not scraped or estimated, your store's actual measured data) and shows them alongside your SEO score so you can see whether a fix actually moved anything. Available from Growth and above.

Why does it say my account has no verified properties? Search Console only shows properties the connected Google account has proven ownership of. If your store's domain has never been verified in Search Console under that account, there's nothing for the app to read yet. The app can walk you through verifying it automatically from Settings: you'll place a small verification tag via a theme toggle rather than editing any code by hand.

Why is today's data missing? Google publishes search performance data about three days behind, so the most recent couple of days are always incomplete. That gap is on Google's side; the app refreshes automatically once a day and simply shows what Google has published so far.

Multi-language SEO

What does this translate? Just the SEO fields: meta titles, meta descriptions and similar metadata, into the store's other published languages. It does not translate your product descriptions or theme content; that's Shopify's own Translate & Adapt or a dedicated localization app's job. Available on Pro, for up to 20 markets.

Why does it say I need to approve a permission? Reading which languages your store publishes requires a specific Shopify permission. If you installed the app before that permission existed in a given version, Shopify asks you to approve it once: reopen the app from your Shopify admin and you'll see the prompt. Nothing else in the app is affected while you do that.

Reports

What's in a scheduled report? A summary of your store's SEO score, issues found and fixed, and (if connected) your Search Console figures for the period, sent to whichever email addresses you choose in Settings. Available on Growth and above.

What does white-label mean? On Pro, reports can carry your own logo, brand name and accent colour instead of RankBoost AI's, useful if you're an agency sending reports to your own clients under your own name.

Still stuck?

Email contact-us@gettheapp.io. That's the same address the app itself uses, so a reply reaches a real inbox rather than a no-reply address. Paid plans get a faster response; every plan gets a real one.