Appearance
Onboarding
The first time you open Keystone AI SEO, a setup wizard replaces the dashboard. It scans a sample of your catalog, asks who you sell to and where they shop, and walks you through the first product optimization, FAQ block, LLMs.txt file, and workflow.
You can leave the wizard early, and you can run it again later from Settings.
Welcome
The welcome screen explains what the wizard will do: scan the catalog, confirm your store profile, fix the weakest content, and set up LLMs.txt and a workflow.
Click Get Started. Keystone then analyzes the store. That scan usually takes about 15 seconds. If it fails, Try again runs it once more.
Setup follows this path:
- Welcome and a short catalog scan
- Store context — customers, markets, industry, and brand voice
- Catalog review and content gaps
- Optimize a product, add FAQs, generate LLMs.txt, and create a workflow
- Setup complete summary
You can dismiss setup at any time with the close control and come back to the same tasks from the sidebar later.
Store context: customers and markets
Who are your customers, and where? is the profile Keystone writes from. The same answers power content generation and AI Visibility when it asks models about your store.
Where are your customers?
| Option | What it means |
|---|---|
| Around the world | Questions are not tied to one country. AI Visibility uses your Shopify billing country when it queries assistants. |
| Specific regions and countries | Pick a region on the map, then every country you sell in. The map zooms in, and AI Visibility names those markets when it asks each model. |
Regions you can choose from:
- North America
- Latin America
- Europe
- Middle East & Africa
- Asia Pacific
Selected countries appear under Your markets. You need at least one country if you choose specific markets, or you can switch back to Around the world.
Choosing markets does three things:
- Geo-aware AI Visibility — buyer-question scans ask ChatGPT, Perplexity, Google AI, Gemini, and Shopify Agentic in the markets you actually sell into.
- Better content targeting — generated titles, descriptions, FAQs, and articles speak to shoppers in those markets.
- Editable anytime — the same store context lives under Settings → Store context. Change markets later without redoing the whole wizard.
Other fields on this step
You also need:
- Industry / niche
- Describe your ideal customer — who buys from you
- What problems does your store solve for customers? — frustrations Keystone turns into phrases shoppers and AI assistants search for
- Brand voice — Professional, Casual & friendly, Luxury and premium, Technical & detailed, Playful & fun, or Minimalist & clean
Click Next step when those fields are filled in. The same answers are editable later under Store context in Settings. Settings also has an optional Target audience field that the wizard does not ask for.
Your content gaps
Keystone shows how search-ready the sampled products are and which products need attention first. The sample is a slice of the catalog, not every product. Continue moves on to the setup actions.
Setup actions
Each action stays on screen until you complete it (or skip FAQ setup). Continue stays unavailable until that step is done. Back returns to the previous step.
Optimize your first product
Optimize opens your weakest-scoring product, or the product list if the scan did not find one. Run an optimization there, then return to the wizard. The step is complete after that optimization finishes. You'll see Keystone improve titles, descriptions, meta tags, FAQs, and image alt text.
Add FAQs to your storefront
This step opens the Shopify theme editor so the Keystone FAQ block can show generated questions and answers. That helps ChatGPT, Perplexity, Google, and other assistants answer questions about your products.
On an Online Store 2.0 theme:
- Click Open product template and Open article template.
- In each editor, add the Keystone FAQ block where you want it — usually below the description or article body. Use Add block or Add section, then find Keystone FAQ.
- Click Save in the theme editor.
- Return to the wizard. Opening both editors marks the step complete.
You can Skip for now. FAQs are still generated and stored, but shoppers will not see them until the block is on the theme.
Vintage themes cannot add app blocks from the theme editor. The wizard explains that and links to the legacy theme FAQ installation guide. Skip the step and add the snippet later, or upgrade to an Online Store 2.0 theme.
You only add the block once per theme. A theme switch means adding it again.
Generate LLMs.txt
Open goes to the LLMs.txt page so you can create a discovery file AI systems use to find your catalog. Opening the page marks this step complete. You can regenerate the file later from LLMs.txt whenever products change.
Automate your optimizations
Open starts a product workflow. Name it, choose products and fields, and set the schedule. Creating the workflow marks this step complete.
New workflows default to running as soon as you save them, then repeating every 30 days. You can choose Just once or any interval from 1 to 365 days. See Product Workflows or Article Workflows.
Finish setup
The last screen, Your store is ready!, summarizes the business name, catalog size, sampled AI readiness score, market, industry, and brand voice.
Click Finish setup to close the wizard and open the dashboard. Your store context is saved.
Leaving and starting again
Can I skip onboarding?
Yes. The close control dismisses the wizard even if steps are unfinished. You can optimize products, add the FAQ block, generate LLMs.txt, create workflows, and open AI Visibility from the app navigation whenever you want. Store context, including selling markets, can be filled in later under Settings → Store context.
Can I redo onboarding?
Yes. In Settings, Restart onboarding clears the saved store context and opens the wizard from the start. Existing product optimizations and workflows are not removed or reverted.
Can I change my answers without restarting?
Yes. Settings → Store context edits the same profile. Save there and later optimizations use the new answers. Already published content stays as it is until you optimize it again.
What happens next
After onboarding you land on the dashboard. From there, open AI Visibility to see where assistants recommend you — using the markets you selected — and what to fix next. You can also open workflows, optimize a single product or article, manage LLMs.txt, or return to Settings.