Improve with AI

← Back to documentation

What the suggestions cover

Improve with AI on the analysis page opens the improve page and starts generating. The button is always available, full marks included: a full score says the checks are met, not that the wording cannot be bettered, and the improve page says plainly when a rewrite would score the same.

• Description. One rewritten description, at least 150 words, in the language of your current text.
• Title. One alternative (occasionally more), under 70 characters and different from the current title.
• Category fields. Values for the category's attributes that are still empty, chosen only from the values Shopify's taxonomy allows for that attribute, and only where your text supports the choice. When the category audit flags a filled value as wrong, a replacement is suggested too.
• Category. When the product has no category, a category from Shopify's taxonomy that fits the text; a category is only assigned when one truly fits, because none is better than a wrong one. When the current category looks wrong, the best replacement the audit found, which you should check before applying.

The page also lists what AI cannot write for you: your images, the store policies (with a link to Shopify's policy settings), and the remaining gaps from the breakdown under More opportunities.

Before it writes: a few questions

The description check often deducts for facts the listing does not give: the upper material, the heel height, whether the shoes run true to size. Those are facts only you know, and the suggestions never invent them, so a rewrite on its own could not earn those points back. When the analysis found such gaps, the improve page asks you about them first, in short questions, before it writes anything. A question about a category field lets you tick its values from a list. What changes with your stock, like the sizes or colours on offer, is never asked and never written into the description.

• Answer what you know. Your answers are treated like your listing: the suggested description states them where a shopper would look for them, in plain sentences, and the rating model scores the result like any other text.
• Skip what you do not. A question you leave blank stays out of the text, and the check keeps deducting for it until the listing says it. Skip for now writes nothing and generates straight away.
• Answered once. Your answers are kept for that product, so a later analysis that asks the same thing finds them filled in. After the suggestions are on screen, Facts you added, right under the score, lists them, lets you correct one, and lets you answer the ones you skipped and generate again.

The answers are used only to write your suggestions. They are not written to the product or shown anywhere on your store; what reaches your storefront is the description you review and save.

The rules the suggestions follow

• No invented facts. A suggestion keeps every factual claim in your listing and adds no materials, measurements, certifications or other facts that are not already in your own text or in the answers you gave before it was written. Category values are picked only when the title or description clearly says so; otherwise nothing is picked.
• Same language. Suggestions are written in the language of your existing listing.
• Written for the rater. The model is given the same rubric that scores your product, then each draft is scored by the fixed rating model and rewritten against the critique, one more round, kept only when it scores higher. What you see is the best draft, with the points it is expected to earn.
• Nothing is applied without you. A suggestion only fills the form on the improve page. Your product does not change until you press Save, or Apply all suggestions and confirm.

Reviewing and editing

• Title: each suggestion has a Use this button that puts it in the title field, and a dismiss button. Edit the field freely afterwards.
• Description: a plain text editor with a word count and the suggested description below it with a Use this button.
• Category fields: chips per attribute with the suggested value marked; Accept the suggestion (or Accept all N suggestions) fills them, and you can pick other allowed values or add your own. Attributes that come from a product option (Color, when it is a variant option) are set by the option and cannot be changed here.
• Category: Assign a category or Change the category shows the suggested one under the category field, the way Shopify's own picker does; click it to choose it, or click the field to search or browse Shopify's categories for any other. Save writes it with the rest of your changes; then the fields for the new category load so you can fill them.

Some attributes are saved together (Color with Pattern, for example): a suggestion carries both, and a save with only half of such a pair is stopped with a note rather than written.

Apply all suggestions, the page's primary action, takes every suggestion on the page at once, a rewrite the judge scores the same as your current text included: it fills the title and the description, accepts every category field suggestion, saves, then assigns a pending category and fills that category's fields too. It first shows exactly what will be written and asks you to confirm; you can tick Don't ask again on this device.

The badges (+N points, up to +N points) are the points a check is expected to earn from that suggestion, and the line at the top adds them up into an expected score. The real score after the next analysis can differ slightly, because the catalog checks are live.

Saving: what is written to your store

The title, description and picked category fields are saved together from the save bar (Save and Discard), as one write that succeeds or fails as a whole: if any part cannot be written, for example a category field Shopify does not accept on that category, the title and description are put back and the product is left exactly as it was, and the message says so. Leaving the page with unsaved edits asks you to confirm. Only the fields you changed are written, and nothing else on the product is touched:

Field	What is written
Title	The product title.
Description	The product description as paragraphs, with the blocks your current description carries kept under the new text exactly as they are: tables (a size chart), images, videos and the blocks size guide apps add. The editor holds the prose alone and says what is kept. Headings and lists in the old text are rewritten as paragraphs; paragraph breaks are kept.
Category	The product's category in Shopify's taxonomy. Written when you press Save after choosing it.
Category fields	The values you picked, as the category metafields Shopify defines for that category. Octolift creates the field definitions and the taxonomy value entries a store does not have yet.

After a save the product is analyzed again on its own, and the score on the page changes when the new result lands. If that fails, an Analyze again button appears.

History and undo

Every change you apply is recorded together with the previous value, the suggestion it came from, and whether you applied it as suggested, edited it first, or wrote your own. On the Products page, press Improvements on the product's row to see them, newest first.

• Title and description changes can be undone there with the Undo button on each (Undo all appears when several can be undone), as long as the product still holds what Octolift wrote. If you have edited that field since, the undo is refused rather than overwriting your work.
• Category and category field changes can be undone when the app recorded what to go back to: the category the product had before, or the value a category field held. When it did not (the product had no category before, the row predates the undo record, or the value goes back together with another field), the row says why, and you change it on the product in Shopify instead.
• An undo is recorded as a change of its own, pointing at what it undid, so the history stays a complete account of what happened.
• History is kept for 30 days, after which it is deleted; a change can only be undone within that window. The product's score history stays.

What it costs

Improving costs nothing on its own. A product is counted against your plan the first time you analyze it (see Plans and what they cover), and everything after that is included: generate the suggestions, rewrite them, apply, apply again, come back next month and do it once more.

When every product your plan covers has been analyzed, those products stay open and nothing you do to them costs anything further. Taking on a product you have not analyzed before is what needs a larger plan.

Related guides