User Guide
← Back to Shelf

Welcome to Shelf

Shelf is a plain-English assistant for your Shopify store. Type what you want, review the preview, say yes. Every change is reversible.

Confirm a change
yes confirm go ahead
Reject a change
no cancel discard
Undo last publish
undo

✏️ Product rewrites

Shelf fetches the official brand website, reads the current listing, and rewrites the title, description, SEO title, and meta description. It shows a preview before anything changes — and you can ask for adjustments before confirming.

Try saying
rewrite the KEF LS50 Meta rewrite the Rega Planar 3 rewrite all active Linn products
Adjust the preview before confirming
make the description shorter the SEO title is too long add a mention of our Norwich showroom

🔍 SEO audit

Run a check across your store. Shelf flags missing SEO titles, short descriptions, meta descriptions that are too long or short, and broken internal links. Fix products one by one, or skip and move on.

Try saying
audit all active Sonos products check the SEO on the Rega range which products are missing meta descriptions?
After the audit
fix the first one next skip this one

💷 Price changes

Change one product or an entire brand at once. Always shows a preview first — no price is touched until you confirm.

Try saying
change the Sonos Beam to £399 put all Rega products up 5% change all Linn Klimax products to £29999

You can also upload a CSV or Excel pricelist and Shelf will match each row to your products automatically.

📅 Scheduled changes

Set a price or status to change automatically on a specific date — useful for promotions and sale end dates.

One change at a time. If you need to change a price now and revert it later, do them as two separate instructions.

Step 1 — do the immediate change now
change the Sonos Beam to £359
Step 2 — schedule the revert
schedule the Sonos Beam to £449 on 7th June
More examples
put the Rega Planar 3 to £499 on Monday at 9am archive the KEF Reference 5 Meta on 1st July what's scheduled? cancel job #2

📦 Stock & product status

Try saying
what's out of stock? list all products in draft show me all active Arcam products list all Sonos products

🔎 Competitor prices

Shelf searches UK retailers and shows you what they're charging for the same product.

Try saying
what are others charging for the Rega Planar 3? check competitor prices for the Sonos Arc Ultra

📝 Blog posts

Shelf writes a full article for your store blog, with SEO title and meta description included. You can also upload a press release or review as a PDF or Word document — Shelf reads it and uses it as the source.

Try saying
write a blog post about the new KEF LS60 Wireless write a news post announcing our Linn listening event

🗂️ Collection pages

Try saying
rewrite the Rega collection page update the description for the KEF speakers collection

🆕 New product listings

Shelf writes a full listing including SEO. New products are saved as drafts in Shopify — add images and set them to active when you're ready.

Try saying
create a new product for the Innuos Nazaré at £21500 create a new product from https://... at £1299

🛒 eBay listings

Generates a formatted Word document you can download and paste directly into eBay.

Try saying
create an eBay listing for the Rega Planar 3

📎 File uploads

Use the paperclip icon in the chat to upload files.

File typeWhat happens
PDF spec sheetShelf reads the specs and uses them for a rewrite or new listing
PDF review or press releaseShelf offers to turn it into a blog post or product rewrite
.docx Word documentSame as PDF
CSV or ExcelTreated as a pricelist — Shelf matches rows to products and previews the changes
JPG / PNG imageAttached to the current product or article when you confirm

↩️ Undo

Every publish can be reversed. Shelf stores the previous title, description, SEO title, and meta description before making any change.

After publishing, say
undo

⚠️ What Shelf doesn't cover

Shelf handles descriptions, SEO, prices, status, and basic product management. A few things need Shopify Admin directly:

TaskWhere to do it instead
URL handle changes — Shelf writes SEO content but can't change the product's URL slug Shopify Admin → Products → open product → Search engine listing → Edit
Uploading images to existing products — Shelf can attach an image when creating a new product; it can update image alt texts on existing ones Shopify Admin → Products → Media
Adding, removing, or renaming variants — price changes apply across all variants, but the variant structure itself (colours, sizes, etc.) can't be edited Shopify Admin → Products → Variants
Adjusting inventory/stock levels — Shelf can read stock counts but not change them Shopify Admin → Products → Inventory, or your 3PL/WMS
Orders, customers, and discounts — Shelf is for content and product management only Shopify Admin → Orders / Customers / Discounts
Compound scheduling — e.g. "reduce by 5% every Monday" or "run this every week". Each scheduled action must be set up individually Set one future action at a time in Shelf, or use Shopify Scripts/Flow for recurring rules

Batch rewrites are chunked at 5 products per round. After each group publishes, say continue to write the next five. This keeps each publish fast and reversible.

Undo stores the last 4 publish batches. Anything older than that can't be reversed through Shelf — check Shopify Admin's product edit history if you need to go further back.

Practice tasks

Work through these to get familiar with each feature. Replace the product names with ones from your own store.

Rewrite a product

Type this
rewrite the Sonos Arc Ultra
Then ask for one change
make the opening line punchier
Then confirm
yes

Fix SEO

Run an audit
audit all active Sonos products
Fix the first issue
fix the first one
Confirm
yes

Change a price and undo it

Change the price
change the Sonos Beam to £399
Confirm
yes
Undo it
undo

Schedule a price revert

Change the price now
change the Sonos Beam to £359 yes
Schedule it back
schedule the Sonos Beam to £449 on 7th June confirm
Check the schedule
what's scheduled?

Stock check

Type this
what's out of stock?
Then
list all products in draft

Competitor prices

Type this
what are others charging for the Rega Planar 3?

Rewrite a collection page

Type this
rewrite the Sonos collection page
Confirm
yes

Write a blog post

Type this
write a blog post about our summer listening event
Ask for a change
add a line about booking by calling the shop
Confirm
yes

Create a new product

Type this
create a new product for the Sonos Era 100 at £249
Confirm
yes

Check Shopify admin → Products. It should appear as a Draft.

Send an error report

Type this
send error report

You should receive a reference code like SHF-XXXX.

💡 Tips
  • Typos are fine. "sonos sub mino" will find the Sonos Sub Mini.
  • Adjust before confirming. Describe any change to the preview and Shelf will update it.
  • "Next" moves through queues. After publishing in a batch or audit, say next to continue.
  • Prices never change during a rewrite unless you specifically ask.
  • Schedule one action at a time. Change now, then separately schedule the revert.
  • Something wrong? Say send error report — your conversation is included automatically.