Keystone Shopify Apps

Appearance

Product and Article Optimization ​

Product Optimization and Article Optimization give you hands-on control over a single item. Workflows handle batches. These pages are for reviewing what the AI generated, making your own tweaks, or optimizing something that does not need a workflow.

When to Optimize a Single Item ​

Use Product Optimization or Article Optimization when you want to:

  • Fine-tune AI-generated content after a workflow has run
  • Optimize a single new product or article quickly
  • Make targeted edits to specific SEO fields
  • Review and adjust content before it goes live (if you prefer a hands-on approach)
  • Fix a specific product's SEO without affecting other items

If you need to optimize many items at once, a product workflow or article workflow is more efficient.

Finding an Item ​

The app navigation has two lists:

  • Product Optimization — products in your Shopify store
  • Article Optimization — blog articles in your Shopify store

Finding your item ​

Each list has a search bar for finding items by name. You can also scroll through the list and use pagination if your store has many products or articles.

Click on any item to open it in the single item editor.

The Single Item Editor ​

The editor is where all the detailed work happens. When you open a product or article, you'll see a full-page editing interface with every SEO field available for direct editing, plus AI generation tools and a live preview.

Editable Fields ​

Title ​

The product title or article headline. This is the primary identifier for the item on your store and in search results. When editing, consider including relevant keywords naturally while keeping the title clear and appealing to shoppers or readers.

Description / Content ​

A rich text editor for the main body content. For products, this is the product description. For articles, this is the full article body.

The editor includes formatting tools for:

  • Bold and italic text
  • Ordered and unordered lists
  • Headings (multiple levels)
  • Links (to other pages, products, or external resources)
  • Other standard formatting options

The rich text editor preserves your formatting when saving to Shopify, so what you see in the editor is what your customers will see on your store.

Meta Title ​

The title that appears as the clickable headline in search engine results. This is one of the most important SEO fields — it directly affects whether searchers click through to your page.

Best practices for meta titles:

  • Keep it under 60 characters to avoid truncation in search results
  • Include your primary keyword near the beginning
  • Make it compelling and specific to encourage clicks
  • Avoid keyword stuffing — it should read naturally

Meta Description ​

The short summary that appears below the meta title in search results. While meta descriptions don't directly affect rankings, they heavily influence click-through rates.

Best practices for meta descriptions:

  • Keep it under 160 characters
  • Summarize the page's value proposition clearly
  • Include a call to action when appropriate (e.g., "Shop now," "Learn more")
  • Include relevant keywords — search engines bold matching terms in the description

Alt Text ​

Alternative text for images. For products, this applies to product images. For articles, it applies to the featured image.

Alt text serves two purposes: it makes your images accessible to screen readers (used by visually impaired visitors), and it helps search engines understand what your images show — which can drive traffic through image search results.

Good alt text is descriptive and specific. Instead of "product photo," write "navy blue merino wool sweater with crew neck on wooden hanger."

FAQ ​

Question-and-answer pairs related to the product or article. You can:

  • Add new FAQ entries with a question and answer
  • Edit existing entries directly
  • Remove entries you don't want

FAQ content appears on your storefront through the FAQ block (if enabled in your theme — see Onboarding). It also helps with search discoverability, especially for voice search queries and Google's featured snippets.

SEO Preview ​

Below or alongside the meta fields, you'll see a live preview that shows exactly how your item will appear in search engine results. The preview updates in real time as you type changes to the meta title and meta description.

This preview mimics the format of a Google search result, showing:

  • The meta title as a clickable blue link
  • The page URL
  • The meta description as grey body text

Use this preview to check for truncation (if your title or description is too long, it gets cut off with "...") and to make sure the result looks compelling.

Generating AI Improvements ​

Click Optimize Now to have Keystone analyze the current content. Products and articles do not behave the same way after that click.

Products ​

Above the form, Fields to optimize offers three shortcuts:

  • Select all — include every available field
  • Select failing — include only fields the SEO score currently marks as failing
  • Clear — remove every field

Each field also has its own Optimize checkbox. Optimize Now needs at least one field selected.

The product title is available and starts unchecked. Description, meta title, meta description, and FAQ start checked. Alt text is included only when the product has an image.

What happens next:

  1. Click Optimize Now.
  2. Keystone rewrites the selected fields and puts the suggestions in the form.
  3. Review them. Edit anything you want to change.
  4. Click Save to publish, or Discard to drop the suggestions.

Nothing is written to Shopify until you save. Version History records the change at save time.

Articles ​

Optimize Now asks you to confirm first. The dialog says the optimization spends optimization credits and saves the changes. After you confirm, Keystone writes the optimized fields to the article immediately. The toast Article optimized successfully means the live article has already updated.

Alt text is written only when the article already has an image. If there is no image, the rest of the fields still update.

You can still edit the article afterward and save again. Version History records the optimization as soon as it completes.

When to generate vs. edit manually ​

Use Optimize Now when you want a strong starting point. Edit by hand when you have specific phrasing or a brand voice you want to keep. On products, the usual path is to generate, refine the form, then save. On articles, generate first, then open the fields and adjust if the saved result needs a change.

Saving and Discarding Changes ​

When you make any changes (manual edits or AI-generated suggestions), a save bar appears at the bottom of the page with two options:

Save ​

Pushes all your changes to Shopify immediately. Your product or article updates on your live store as soon as you save.

Every save is recorded in the item's Version History, so you can always see what changed and revert if needed.

Discard ​

Reverts all unsaved changes. The fields return to their previously saved state. This is useful if you've been experimenting with different phrasing and want to start over.

Tips ​

  • Use the SEO preview constantly. It's the fastest way to catch truncation issues and ensure your meta content reads well in search results.

  • Don't over-optimize titles. A title stuffed with keywords reads poorly and can actually hurt your rankings. Aim for one primary keyword, naturally placed.

  • Write meta descriptions that sell. Think of the meta description as a mini-advertisement for your page. What would make someone click?

  • Be specific with alt text. Descriptive alt text like "red leather crossbody bag with gold chain strap" performs much better than generic text like "product image."

  • Check FAQ relevance. AI-generated FAQs are usually on-target, but occasionally you may want to remove a question that doesn't apply or add one that your customers frequently ask.