AI Collections Optimiser
Audit and rewrite the body content of every Shopify collection — focus-keyword checked and on-brand.
AI Collections Optimiser Collection pages are some of the highest-intent pages on a Shopify store, yet their body content is often empty or thin. The AI Collections Optimiser audits the body content of every published collection, scores it, and rewrites it as detailed, on-brand copy — grounded in the products the collection actually contains. This tool optimises a collection's body content (the description shown on the collection page). The AI Meta Data Optimiser handles each collection's SEO meta title and description — the two are complementary. The content audit For each collection, the optimiser uses the collection's own name as the focus keyword — a direct, verbatim quote of the title (exact case and punctuation, e.g. "F-117 Nighthawk") — then checks how the body content measures up. The keyword check is case- and punctuation-tolerant, so it still matches your copy however it's written: 🟢 Optimised — enough content and the focus keyword appears in it. 🟡 No keyword — enough content, but the focus keyword is missing. 🟡 Too short — has content, but too thin to describe the collection. 🔴 Missing — no body content at all Each collection gets a 0–100 content score, and the dashboard shows an overall score with a funnel you can click to filter the table — for example, to see only the collections that are missing content or missing the keyword. This overall score also feeds your store's SEO Health score on the app home page, so improving your collection content lifts your headline number too. Custom SEO metafields are tracked separately from this content score — see Metafield health below — so filling them never disturbs your content number, and collections that don't use metafields are never penalised. Focus keyword highlighting When you open a collection, the current body content is shown with every occurrence of the focus keyword highlighted in green, plus a count of how many times it appears. This makes it obvious at a glance whether the keyword is present and used naturally. Optimising content with AI Open a collection from the table. Review the current content and the keyword audit. Click 'Optimise with AI' and choose an action — Add keyword, Shorten, Extend, or Full rewrite. Edit the draft in the rich editor — format headings, sub-headings, links and lists with the toolbar. Click 'Save to Shopify' to write the new content to the collection Optimise with AI offers four actions, so you can make the smallest change that fixes what's actually wrong instead of rewriting good copy every time: Add keyword — when the content is good but the focus keyword is missing, the AI weaves it in by editing just a sentence or two, leaving everything else untouched. Shorten — when the content is too long or repetitive, the AI removes duplicate and redundant lines and tightens the copy toward 300–500 words, keeping every distinct point. Extend — when the content is too thin, the AI keeps what's there and adds a sentence or short paragraph (grounded in the collection's products) to reach the length target. Full rewrite — writes a fresh, detailed description of around 300–500 words from scratch, or improves and expands existing copy Every action uses a sample of the collection's products as context, keeps the focus keyword reading naturally, and follows your brand voice. Add keyword, Shorten and Extend are surgical edits that preserve your existing headings, links and lists — only Full rewrite starts the copy over. Actions that don't apply to the current draft are shown but disabled (for example, Add keyword switches off once the keyword is already present). The editor is a rich text editor that works on the collection's actual HTML, so any existing structure — headings, sub-headings, links and lists — comes through and is preserved exactly, instead of being flattened into plain paragraphs. This keeps the SEO value of your headings intact. (The collection title is the page's H1, so the body editor offers H2 and H3 only.) Saved content is sanitised automatically to strip anything unsafe. Tip: Assign a tone and writer persona to the AI Collections Optimiser in the Brand Voice Builder so every description sounds like your brand. SEO meta (title & description) The Optimise dialog also pulls each collection's SEO meta title and description — the text shoppers see in Google's search results — so you can fix the page content and its [[gloss:snippet|search snippet]] in one place. Edit them with the same surgical AI actions (Add keyword, Shorten, Expand, Rewrite), preview the snippet, and save them alongside the body. Only the fields you change are written, and the meta save reads-then-merges, so updating the title never clears the description. Custom SEO metafields Some stores keep extra SEO copy in custom metafields — an 'SEO intro', a 'meta blurb', a footer note, an 'SEO paragraph' — rather than in the body or the search snippet. When you open a collection, the Optimise dialog also loads its metafields, each labelled by its metafield name, so you can edit them by hand or generate a value with AI (the same on-brand, product-grounded writing as the body). Single- and multi-line text fields edit as plain text; rich text fields edit in the full rich editor (headings, lists, links and bold/italic) just like the collection body. They save to Shopify alongside your other changes — each metafield is written independently, so saving one never clears another. Your metafield completeness across the store is tracked as its own Metafield health score, separate from the content score (see below). Text and rich text metafields are shown, and only where Shopify lets us edit them. A metafield created by another app and locked to that app is Shopify's boundary, not a permissions setting — those appear as read-only or are summarised as 'managed by another app', and no reconnection or extra scope can unlock them. Editing custom metafields uses the same write_products permission the tool already has. Metafield health When your store has editable custom SEO metafields, a separate Metafield health panel appears above the table with its own 0–100 score — how completely your collections fill those metafields, graded independently of the content score. A collection counts as Complete when every editable metafield has content, Partial when some do, and Missing when none do. Click any segment of the funnel to filter the table to just those collections, then use the 'Incomplete metafield content' export band (every collection that isn't Complete) to pull them into a CSV and bulk-fill the gaps. Because it's a separate metric, filling metafields never changes your content score and stores that don't use metafields never see this panel at all. Bulk edit with CSV To rewrite many collections at once, export a CSV, edit it in any spreadsheet, then import it back. Use the Export button to download your collections — all of them, or just one band (missing content, missing the keyword, too short, or — when your store uses custom metafields — missing metafield content). Each row carries the collection's current body in a 'current_body' column and an empty 'new_body' column for your edits. If your store keeps SEO copy in custom text metafields, the same CSV lets you bulk-edit those too. For every editable text metafield, the file adds a matching pair of columns — 'current_mf:<namespace>.<key>' with the live value and an empty 'new_mf:<namespace>.<key>' for your edit (for example 'current_mf:custom.seo_heading' / 'new_mf:custom.seo_heading'). One row can change the body, one metafield, several, or any mix — leave the columns you don't want to touch blank. The columns match exactly what you can edit in the Optimise dialog, including custom metafields created by an app or the API that have no store-level definition. (On collections with an unusually large number of metafields, only the first several undefined metafields are covered by the bulk file; metafields you've defined in Shopify's Settings → Custom data are always included.) The body round-trips as HTML, so 'current_body' contains the collection's HTML (headings, links, lists and all). Put your new HTML in the 'new_body' column for the collections you want to change — keep the tags to preserve structure.. Prefer plain text? You can just type it in 'new_body' instead of HTML — each line break (Enter) becomes its own paragraph, so two lines import as two paragraphs. Real HTML is left as-is; only tag-free text is wrapped.. Metafield columns follow the same rules: single- and multi-line text edit as plain text, and rich text metafields round-trip as HTML (edit the text and keep the tags). Only metafields QueryCatch is allowed to edit get a 'new_mf:' column; ones locked to another app are never included.. Leave any 'new_body' or 'new_mf:' cell blank to make no change — a blank cell is always ignored, so an import can never clear or remove existing content, whether it's the body or a metafield.. Import the file (up to 20,000 rows, 10MB — filter or export one band at a time to stay under the size limit on large stores). Imported content is sanitised, so anything unsafe is stripped before it reaches your store.. Every import shows a review screen first: the additions and changes it will make, any rows that changed in your store since you exported (conflicts, excluded unless you opt in), and any rejected rows with the reason — nothing is written until you confirm. Rows are matched by their 'querycatch_id' — don't edit that column. The context columns (title, url) are there to help you find a row; only 'new_body' is applied. Requirements A connected Shopify store. Write permission for products (write_products). Included with the same plan as the AI Meta Data Optimiser. Available inside the Shopify admin as an embedded app Best practices Aim for around 300–500 words of specific, descriptive copy — enough to cover the collection well. Use the focus keyword once or twice, naturally — never keyword-stuff. Describe what makes the collection worth browsing, not just what's in it. Review the AI draft before saving — you always have the final say Saving replaces the collection's existing body content with your new copy. Review the draft in the preview before you save.Documentation
Everything you need to know about using QueryCatch