Appearance
Getting Started with Keystone AI SEO
Keystone AI SEO is a Shopify app that uses artificial intelligence to optimize your store's SEO. It generates improved product titles, descriptions, meta tags, FAQs, and image alt text — helping your products and articles rank higher in search engines and AI-powered discovery tools.
This guide walks you through everything you need to know, from initial setup to managing ongoing optimizations.
Table of Contents
- Onboarding (First-Time Setup)
- Dashboard Overview
- Creating a Product Workflow
- Creating an Article Workflow
- Managing Workflows
- Manual Optimization
- Version History
- FAQ and Tips
1. Onboarding (First-Time Setup)
When you first open Keystone AI SEO from your Shopify admin, you'll see a guided onboarding card on the dashboard. There are three steps to complete:
Step 1: Optimise Your First Product
Pick a product and see how Keystone improves it for AI search. Click "Choose a product" to select a product from your store. Keystone's AI will optimize its SEO fields so you can see the results firsthand.
Step 2: Add FAQs to Your Storefront
Help ChatGPT, Perplexity, Google and LLMs alike answer questions about your products. Clicking "Enable FAQ block" opens the Shopify theme editor where you can add the FAQ block to your page templates. This allows AI-generated FAQs to display on your storefront.
Step 3: Automate Your Optimisations
Set up a workflow so Keystone keeps your content optimised automatically. Click "Create workflow" to head to the Workflows page and set one up. See Creating a Product Workflow or Creating an Article Workflow below for a full walkthrough.
Finishing Up
Once all three steps are complete, a "Finish Onboarding" button appears. Click it to dismiss the onboarding card and reveal the full dashboard. You can also dismiss onboarding at any time by clicking the X button if you'd prefer to set things up later.
2. Dashboard Overview
After onboarding, the dashboard is your home screen. Here's what you'll find:
Quick Links
Two shortcut cards give you fast access to your workflows:
- Product Optimization — jump straight to your product workflows
- Content Optimization — jump straight to your article workflows
Click "View all" to see every workflow you've created.
Help Banner
A dismissible card at the bottom offers two ways to get assistance:
- Book a call — schedule a free setup call with the Keystone team
- Contact Support — opens a live chat widget for direct support
3. Creating a Product Workflow
Navigate to Workflows from the sidebar, then click "Create new workflow" under the Product Optimization section.
Step-by-Step
1. Name Your Workflow
Enter a descriptive name in the Workflow Name field (e.g., "Summer Collection SEO" or "Weekly Product Refresh"). This is required.
2. Select Products
Click "Select Specific Products" to open the Shopify product picker. Browse or search for the products you want to optimize, then confirm your selection.
Your selected products appear in a list below. You can:
- Search through your selected products by name
- Remove individual products by clicking the remove button next to each one
- Page through your selection if you've picked many products
Note: Products that are already part of an active workflow (scheduled or currently running) won't appear in the picker. Once that workflow completes, the products become available for selection again.
3. Choose Optimization Fields
Select which SEO fields the AI should optimize. The available fields are:
| Field | Description |
|---|---|
| Product Title | The main title shown on your store and in search results |
| Product Description | The full product description displayed on your store |
| Meta Title | The clickable headline that appears in search engine results |
| Meta Description | The short summary shown under the meta title in search results |
| FAQ | Questions and answers that improve product clarity and search discoverability |
| Alt Text | Alternative text for product images, improving accessibility and image SEO |
Meta Title and Meta Description are always included and cannot be deselected — these are the most impactful fields for search rankings.
4. Set a Trigger
Choose when the workflow should run:
- Schedule it — pick a start date and time. The workflow will run at that time and automatically repeat every 30 days to keep your SEO fresh.
- Select a date (must be in the future)
- Set the hour, minute, and AM/PM
- Run now — click the "Run Workflow Now" button in the top-right corner to start optimization immediately
5. Save
Click "Save" in the save bar at the bottom of the page. Your workflow is now scheduled and will appear on the Workflows page.
4. Creating an Article Workflow
Navigate to Workflows from the sidebar, then click "Create new workflow" under the Article Optimization section. The process is very similar to product workflows, with a few differences.
Differences from Product Workflows
Article Selection
Instead of the Shopify product picker, you'll see a Select Articles modal. This modal displays all your blog articles in a list with checkboxes. You can:
- Search articles by title
- Select all available articles on the current page
- Page through your articles
Articles already in an active workflow are shown with a disabled checkbox and a grey background. A banner at the top of the modal explains: "Articles that are already part of an optimization workflow cannot be selected."
Optimization Fields
The fields are tailored for articles:
| Field | Description |
|---|---|
| Article Title | The main headline of the article |
| Article Content | The full body text of the article |
| Meta Title | The clickable headline in search engine results |
| Meta Description | The summary shown under the meta title in search results |
| FAQ | Questions and answers that improve article clarity and discoverability |
| Alt Text | Alternative text for the article's featured image |
As with product workflows, Meta Title and Meta Description are always included.
Scheduling and Saving
The trigger and save options work identically to product workflows — schedule for a future date (repeats every 30 days) or run immediately.
5. Managing Workflows
The Workflows page shows all your workflows organized into two sections: Product Optimization and Article Optimization.
Workflow Table
Each workflow displays the following information:
| Column | What It Shows |
|---|---|
| Name | The workflow name you chose |
| Start | When the workflow is scheduled to run |
| Completed at | When it finished (if applicable) |
| Status | Current status — see below |
| State | Whether the workflow is Enabled or Disabled |
| Trigger | Manual (one-time) or Automatic (recurring) |
| Affected Resources | How many products or articles were processed |
Understanding Statuses
- Scheduled — the workflow is queued and waiting for its start time
- Started — the workflow is currently running and optimizing your items
- Completed — all items were successfully optimized
- Stopped — the workflow was manually disabled or canceled
- Failed — something went wrong during optimization
Actions You Can Take
On individual workflows:
- View (eye icon) — see the workflow details and which items were affected
- Enable/Disable (toggle icon) — pause or resume a recurring workflow
- Delete (trash icon) — remove the workflow permanently
In bulk (select multiple workflows using checkboxes):
- Bulk Enable — enable all selected workflows
- Bulk Disable — disable all selected workflows
- Bulk Delete — remove all selected workflows
Viewing Workflow Details
Click the view icon on any workflow to see its full details, including:
- Workflow name, status, and state
- Trigger type and timing
- A table of all products or articles that were (or will be) optimized, with thumbnails and titles
6. Manual Optimization
Not everything needs a workflow. The Manual Optimization page lets you make one-off SEO improvements to individual products or articles.
When to Use Manual Optimization
- You want to tweak a single product's SEO without setting up a recurring workflow
- You want to review and fine-tune AI suggestions before they go live
- You need to quickly update a specific item
How It Works
- Navigate to Manual Optimization from the sidebar
- Switch between the Products and Articles tabs
- Browse or search for the item you want to optimize
- Click on it to open the editor
The Single Item Editor
When you open a product or article, you'll see a full editing page with these sections:
Editable Fields
All SEO fields are available for direct editing:
- Title — edit the product or article title
- Description / Content — a rich text editor for the main body text, with formatting tools (bold, italic, lists, headings, links, and more)
- Meta Title — edit the search engine title
- Meta Description — edit the search engine description
- Alt Text — edit the image alt text
- FAQ — add, edit, or remove question-and-answer pairs
SEO Preview
A live preview shows exactly how your product or article will appear in search engine results, updating as you type changes to the meta title and meta description.
Generate Improvements0
Click the "Generate Improvements" button to let the AI analyze your content and suggest optimized versions of each field. You can review the suggestions and choose which ones to apply — nothing changes until you save.
Saving
When you make changes, a save bar appears at the bottom of the page:
- Save — pushes your changes to Shopify immediately
- Discard — reverts all unsaved changes
7. Version History
Every change made to a product or article — whether by a workflow or a manual edit — is tracked in the Version History section at the bottom of each single item editor page.
What It Tracks
- Which field was changed (title, description, meta title, etc.)
- The original value before the change
- The new value after the change
- The date and time of the change
- Whether the change was made by a workflow (with a link to that workflow)
Restoring a Previous Version
If an optimization didn't turn out as expected, you can restore a previous version of any field directly from the version history. This gives you full control and peace of mind when using automated workflows.
8. FAQ and Tips
Why can't I select a product or article?
If a product or article appears disabled or hidden in the selection picker, it's because it's already part of an active workflow (either scheduled to run or currently running). Once that workflow completes, the item becomes available for selection again.
How often do workflows run?
Workflows repeat every 30 days from their start date. Adjustable frequency is coming soon.
Which fields are always optimized?
Meta Title and Meta Description are required in every workflow. These two fields have the most direct impact on how your pages appear in search results.
Can I edit AI-generated content before it goes live?
Yes. Use Manual Optimization to open any product or article, review what the AI generated, make your own adjustments, and save when you're satisfied.
Can I undo an optimization?
Yes. Every change is tracked in Version History on the single item editor page. You can restore any previous version of a field at any time.
How do I get help?
Two options are available from the dashboard:
- Book a call — schedule a free setup session with the Keystone team
- Contact Support — open a live chat for immediate assistance