Keystone Documentation

Appearance

Article Workflows ​

Article workflows optimize the SEO of your Shopify blog posts and articles. If your store uses a blog to drive organic traffic — through how-to guides, product spotlights, industry news, or other content — article workflows help ensure that content is discoverable by search engines and AI-powered tools.

The process is very similar to product workflows, with a few key differences in how you select articles and which optimization fields are available.

When to Use an Article Workflow ​

Article workflows are ideal when you want to:

  • Optimize a batch of blog posts for better search rankings
  • Refresh older articles that may have lost visibility over time
  • Ensure new blog content has strong SEO from the start
  • Generate FAQs and alt text for articles in bulk

If you only need to update a single article, Manual Optimization may be a better fit.

Creating an Article Workflow ​

Navigate to Workflows from the sidebar, then click "Create new workflow" under the Article Optimization section.

1. Name Your Workflow ​

Enter a name in the Workflow Name field — the same as with product workflows. Choose something descriptive that helps you identify this workflow later.

Examples:

  • "Blog Refresh — Q1 2026"
  • "Product Guides SEO Update"
  • "Weekly Blog Optimization"

2. Select Articles ​

Click the article selection button to open the Select Articles modal. Unlike product workflows (which use the Shopify product picker), article selection uses a custom modal built specifically for browsing your blog content.

How the article selector works ​

The modal displays all your blog articles in a list, each with a checkbox. You can:

  • Search articles by title using the search bar at the top
  • Select all visible articles on the current page with a single click
  • Page through your articles if you have more than fit on one screen

Select the articles you want to include in the workflow, then confirm your selection.

Unavailable articles ​

Articles that are already part of an active workflow (scheduled or currently running) appear with a disabled checkbox and a grey background. A banner at the top of the modal explains this restriction: "Articles that are already part of an optimization workflow cannot be selected."

Once the active workflow completes or is disabled, those articles become available again. This prevents conflicting optimizations from running on the same article at the same time.

3. Choose Optimization Fields ​

Select which SEO fields the AI should optimize. The fields are tailored for article content.

Available fields ​

Article Title — The main headline of the article. The AI refines it to be more engaging, keyword-rich, and click-worthy while preserving the original intent.

Article Content — The full body text of the article. The AI improves structure, readability, keyword usage, and overall SEO quality. It works with your existing content rather than rewriting from scratch — think of it as a thorough editorial pass focused on search performance.

Meta Title — The clickable headline shown in search engine results. A strong meta title increases the likelihood that searchers will click through to your article. Limited to 60 characters for optimal display.

Meta Description — The summary shown below the meta title in search results. It should give readers a compelling reason to click. Limited to 160 characters for optimal display.

FAQ — AI-generated questions and answers related to the article's topic. These boost discoverability for question-based searches and can appear as rich results in search engines. Requires the FAQ block to be enabled in your theme (see Onboarding).

Alt Text — Alternative text for the article's featured image. This helps with image search visibility and accessibility.

Required fields ​

Just like product workflows, Meta Title and Meta Description are always included and cannot be deselected.

4. Set a Trigger ​

The scheduling options are identical to product workflows.

Scheduled (recurring): Pick a future date and time. The workflow runs at that time and repeats every 30 days automatically.

Run now: Click "Run Workflow Now" to start optimization immediately.

5. Save ​

Click "Save" to create the workflow. It will appear on your Workflows page under the Article Optimization section.

Key Differences from Product Workflows ​

While the overall process is the same, here's a quick summary of what's different:

Article selector vs. product picker. Articles use a custom selection modal with checkboxes, search, select-all, and pagination. Products use the native Shopify product picker.

Field names. "Product Title" becomes "Article Title," "Product Description" becomes "Article Content," and alt text applies to the featured image rather than all product images.

Content depth. Article content optimization tends to involve more substantial text — blog posts are often longer than product descriptions — so the AI's optimization may take slightly more time per item.

Tips for Effective Article Workflows ​

  • Prioritize older content. Articles published more than 6 months ago are great candidates for optimization. Search trends evolve, and refreshing older content can recapture lost rankings.

  • Group articles by topic. Creating workflows around specific themes (e.g., "All product guides" or "Holiday-related posts") keeps your optimization organized and makes results easier to review.

  • Use FAQ generation. FAQ content on articles is especially powerful for capturing featured snippet positions in search results — those answer boxes that appear at the top of Google.

  • Review Article Content changes carefully. Since article bodies tend to be longer and more nuanced than product descriptions, it's worth reviewing the AI's content optimization for a few articles after your first workflow run. Use Manual Optimization to fine-tune if needed.