OneFold AI
Log in Start free
← Back to home
OneFold

Guide

How to do the things OneFold does, written around what you are trying to get done.

Last updated

Getting started

What does OneFold actually do?

OneFold turns product information into a finished listing: title, description, specifications, keywords, alt text and a suggested price range, and then checks that listing before it reaches your store.

The checking is the part worth paying for. Anything can write product copy. OneFold scores whether search engines and AI assistants can actually find it, measures how much of it is supplier text every competitor also published, and validates it against marketplace rules and EU product-safety law: before you publish, not after a rejection.

Nothing is ever published live. Listings arrive in your store as drafts for you to approve.

I have a store already: is this for me?

Yes, and you should not start by uploading a photo.

Connect Shopify or WooCommerce and OneFold pulls your existing products in, scores each one and shows you which are worth fixing first. Nothing in your store changes until you approve it.

If instead you are starting from a supplier photo with no listing yet, the Studio is your path: one photo in, a complete listing out.

Open this in OneFold →

How do I make my first listing?

Open the Studio and drop in one photo: straight from your phone is fine, including HEIC, up to 20MB. Larger photos are resized in your browser before they upload.

OneFold reads the product from the image, writes every field, and then shows you three things: the Visibility score, the Originality score, and anything that would block publishing.

It will also list the handful of facts a photo cannot establish: weight, what is in the box, warranty. Those stay blank until you fill them in. OneFold does not guess them.

Open this in OneFold →

How do I connect my store?

WooCommerce: type your shop's web address and press Connect with WordPress. You go to your own WordPress, WooCommerce asks whether to let OneFold read and edit your products, you press Approve, and you come back connected. Nothing to copy. If your site blocks that screen, the page also lets you paste a REST API key instead.

The address has to start with https://. Over plain http your store keys and products would travel unencrypted, so OneFold does not connect new stores that way. If your shop has no HTTPS yet, turn it on in your hosting first; most hosts include it free.

Shopify: the OneFold app for Shopify is built and waiting for its App Store listing. While that is pending the Integrations page says so and shows no connect button, so that nobody is sent to press a button that is not there. The day the listing is live, an Add OneFold to Shopify button appears on the Integrations page: Shopify asks you to approve OneFold, opens it inside your admin, and Finish connecting ties the shop to your account. Your plan is then billed through Shopify, and you change it from your Shopify admin. Stock levels are not sent by OneFold; set them in Shopify.

In the meantime a Shopify shop still gets everything but the button: press Export on the Listings page and choose Shopify product CSV, then import that file in your Shopify admin under Products > Import. Since 1 January 2026 Shopify no longer lets stores create the custom app the old method needed; if you made one before then, its Admin API access token (starting shpat_) still works — paste it under “I already have a custom app token”.

If a connection fails, OneFold tells you which of those went wrong rather than showing you the raw error.

Open this in OneFold →

If your products live in a spreadsheet

What can I upload?

A .csv, an .xlsx, or a PDF price list, with column names in the first row and one product per row after that. A supplier spreadsheet, an export from your ERP, the PDF catalogue your supplier emails you. Up to 100,000 rows and 20MB per file.

PDFs have to contain real text. If the pages are scans or photographs OneFold tells you so rather than guessing at your prices from a picture. Catalogues that repeat the column headings on every page, or put a section title above each group of products, are handled: those rows are recognised and left out, and anything skipped is listed with the row number you will find in your own file.

When a PDF price list prints a picture beside each product, the picture comes with its row and becomes that listing's photo; the mapping screen says how many it found.

It does not matter what your columns are called or what order they are in. OneFold recognises the usual spellings in several languages (sku, Item No., Artikelnummer) and shows you what it guessed so you can correct it before anything is created.

The file does not have to be on your computer. Paste a link to it from Google Drive, Dropbox, OneDrive or SharePoint, or any direct link to the file (a Google Sheets link works too, and is brought in as .xlsx). The file must be shared as “Anyone with the link”. Proton Drive, MEGA and iCloud links cannot be fetched, because those files are encrypted or open a web page: download them first. You can do the same from the Catalogue audit page.

Open this in OneFold →

What is the mapping screen for?

It asks which of your columns is the product name, which is the price, which is the barcode, and so on. Guesses are filled in already; your own data is shown underneath each one so you are checking against the file rather than your memory of it.

Columns OneFold does not recognise are not thrown away. They are kept with the product under “extra detail”, exactly as they were written. A warehouse bin number or a customs code means nothing to us and a great deal to you.

Does it write descriptions for me?

No, and that is deliberate. Importing MOVES what is already in your file. If a row has no description, the listing has no description, and the score will tell you so.

Writing the missing parts is a separate, explicit step you press afterwards, per product or in bulk. That way you always know which words are yours, which came from your supplier, and which OneFold wrote.

Why did everything I imported score so low?

Because a supplier file usually contains a name, a code and a price, and almost nothing a search engine or a buyer is looking for. A score of 15 or 22 on a freshly imported row is not a fault. It is an accurate measurement of raw supplier data.

That gap is the work. Fix the blocking issues first, then let OneFold write the missing fields, and watch the same rows climb.

What if I upload the same file twice?

Nothing is duplicated. OneFold skips any row whose SKU you already have and tells you which ones, so re-uploading a corrected price list does not leave you with two of everything.

Rows for products already in your connected store are fine too: when you publish a listing whose SKU or barcode matches exactly one product in that store, OneFold updates that product instead of creating a second one. The import result says how many rows it matched. Titles are never used for this, because two different products often share one.

If you genuinely want a second copy there is a checkbox on the mapping screen to allow it.

Does importing use up my plan?

It uses your PRODUCTS allowance, not your LISTINGS allowance. Importing calls no AI — it moves your own values into fields — so none of your monthly AI listings are spent. Scoring the imported rows is free too.

But every imported row becomes a product your account holds, and each plan holds a set number: 100 on Free, 1,000 on Starter, 10,000 on Business, 50,000 on Catalogue. A file with more rows than the room you have left is refused before anything is created, and the message says how many products it would have added and how many you have room for. Half a catalogue, cut off at an arbitrary row, would be worse than none.

This answer used to say simply "No", which was true of the AI allowance and misleading about the product count.

If you already have a catalogue

How do I get my products into OneFold?

Connect the store, then press Sync. OneFold pulls in your products : titles, descriptions, images and identifiers, and leaves them exactly as they are in your store.

The sync is one-way. OneFold reads your catalogue; it does not write anything back until you ask it to, and it never touches stock levels, prices, variants or SKUs.

Open this in OneFold →

I have hundreds of products. Which do I fix first?

Sort by what is actually costing you something. A product that cannot be published because it is missing EU safety details is a legal exposure. A product whose copy is identical to every other seller's is invisible to search. A product with a weak title is merely underperforming.

The products list shows blocking issues as a badge, so the ones carrying real risk are visible without opening each one.

Open this in OneFold →

What will OneFold change in my store?

On a product that is already in your store, only the fields you approve: title, description, SEO fields, keywords, alt text and images.

On those products it does not modify inventory, price, SKU, variants, categories or metafields it did not create.

A product OneFold publishes for the first time is different, because it has to arrive complete: it carries the price, SKU, barcode and any options and SKUs you entered here. It is written as a draft either way, and the publishing log records exactly what went where.

If you are starting from a supplier photo

Why does my supplier's description score badly?

Because ten thousand other shops published the same paragraph. Search engines pick one of those pages to rank, and it is rarely the newest shop.

The Originality score measures how much of your copy you share with competitors: stock supplier phrases, marketing filler, and the tells of unedited AI writing, and names the sentences that cost you the most.

Can OneFold rewrite it for me?

Yes. "Rewrite this in your own words" rebuilds the description using only facts your listing already contains.

It will not invent a weight, a material or a warranty to sound more specific. If it cannot improve the copy without inventing something, it says so and asks you for the missing detail instead.

Can I do many products at once?

Yes, on every plan (on Free, up to your three AI listings a month). In the Studio, choose or drop up to 100 photos in the same box you use for one: a single photo makes one listing, several make a batch with one listing each. Add a short hint per photo if a product needs it.

Each item is reviewed individually before anything publishes, and a failure on one photo does not stop the rest. The batch runs on our servers, so you can refresh or close the page; you get one email when the whole batch is done, listing anything that still needs a detail from you.

A photo you already made a listing from, or a product whose title matches one you already have, is marked as a possible duplicate with a link to the existing listing. It is not deleted: two sizes of one product can share a photo, and only you know.

Photos in Google Drive, Dropbox, OneDrive or anywhere else online can be brought in without downloading them first: paste their links, one per line. They are resized and checked exactly like photos from your computer. Links have to point at single files, not folders. The single-photo Studio and the Add photo panel take a link too.

Open this in OneFold →

My supplier sent one picture with many products on it. What do I do?

Upload it like any other photo. OneFold recognises a grid of products (a catalogue sheet with names and sizes printed under each one), cuts out every product and shows you what it found before anything is made.

Untick anything you do not sell, add a hint where needed, and confirm: each product becomes its own listing. The AI reads the printed name and size; the picture kept for the listing has no text on it, and small pictures are enlarged and sharpened without being redrawn.

Nothing is charged until you confirm. If it is really one product, press It is one product. Upload the same sheet again and the products you already imported are left unticked.

Open this in OneFold →

Can I edit many listings at once, like Shopify's bulk editor?

Yes, and it works the same way. Press Bulk edit on the Listings page (or tick some listings and press Edit selected), Edit all in a grid on a batch, or Bulk edit on the Catalogue audit. You get a spreadsheet: one row per product, one column per field.

Click a cell to change it. Enter or Tab moves to the next cell, Escape puts the old value back. Copy and paste works between cells and straight from Excel or Google Sheets: paste a column and it fills the rows below. Drag the small green square at the corner of a cell to copy its value down. Columns lets you choose which fields to show; the choice is remembered.

Nothing is saved until you press Save. Changed cells are marked, and the bar at the top counts them. If one cell cannot be saved (a price that is not a number, a barcode that does not check out, a blank title), everything else is saved and that cell turns red; hover it to see why.

On the Catalogue audit, Save keeps the change in OneFold and Save and push to store also sends it to your Shopify or WooCommerce store. The In store column says which rows the store has yet.

Open this in OneFold →

Understanding the scores

What is the Visibility score?

Three checks, each out of 100. Search engines: whether Google can index and rank the listing. Answer engines: whether a voice assistant or featured snippet will read it out. AI assistants: whether ChatGPT will cite your product when someone asks for a recommendation.

It is arithmetic, not an AI opinion. The same listing always scores the same, and every check tells you exactly what it wants.

What is the Originality score?

How much of your copy is yours rather than text shared with every other seller of the same product. Under 50 means search engines are likely to treat your page as a duplicate.

What is keyword coverage?

Whether your keywords are still in the places that carry weight: the title, the meta description and the opening lines: not merely present somewhere on the page.

Why is there no keyword ranking?

Because Amazon and Etsy do not publish rank in their APIs, and scraping it breaks their terms and risks your account.

Anyone showing you a rank number for those channels is guessing. OneFold reports what can be measured honestly.

Product images

Will the AI change how my product looks?

Not in the styles marked as keeping your product. Clean white and the studio packshot are your own product cut out of your photo and placed on a square canvas with a soft shadow: nothing is generated. Lifestyle scenes generate the background, then lay your product's real pixels back over it, so labels and shapes stay as photographed.

Some styles have to redraw the product: other camera angles, a product worn by a model or held in a hand. The style picker says so before you choose one, so you know to check the label and shape before publishing.

High resolution uses an enlarger that sharpens the pixels that are there and draws nothing new, so it cannot invent different words on a label.

How do I get my product from different angles?

On a listing, open Camera angles and tick the ones you want: front, 45 degrees left or right, side, back, top-down flat lay, high angle, low angle or close-up. Choose a background and a shape, and optionally describe what the product is. Your choices are remembered for every listing.

The front view is your own photo. Side and back views are reconstructed from the front and marked that way: check them against the real product. Each angle counts against your monthly AI budget, and an angle that fails is not charged.

Enhance prompt rewrites a short instruction of yours into a precise one, keeping what you asked for.

Can I make images for many listings at once?

Yes. Tick listings on the Listings page (or use Select all matching) and press Images for selected, or press Images for this batch on a batch. The same angles, background and resolution are made for every listing, up to 100 at a time, and listings without a photo are named and skipped.

Open this in OneFold →

Barcodes, sizes and structured data

How does the barcode check work?

Type a barcode (EAN, UPC or GTIN) into the listing, or give each size its own in Options & SKUs, or include a barcode column in an imported file. OneFold recognises 8, 12, 13 and 14-digit codes.

The last digit of every barcode is calculated from the others, so a single mistyped digit can be caught. OneFold redoes that sum. A correct barcode is labelled with its type, such as EAN-13. A wrong one gets a plain warning naming the digit it should end in.

When you publish, a correct barcode goes to your store with the product. A wrong one is held back, because a wrong barcode is worse than none: Google matches it to another company's product and your offer is shown in the wrong place.

Handmade, vintage and second-hand products usually have no barcode, and their score is not marked down for the lack of one.

Open this in OneFold →

My product comes in several sizes or colours. What do I do?

Open the listing and use Options & SKUs. Name what it varies by (Size, Colour, up to three), list the values separated by commas, and press Build the list. Every combination becomes a row with its own price, compare-at price, SKU, barcode and stock. Delete any row you do not stock.

Adding a size later keeps everything you have already typed: prices stay with the size they belong to, even if the new size goes in the middle of the list.

A row with no price of its own is sold at the product price. Blank stock means you do not track it; 0 means sold out.

Importing a supplier file that lists one product once per size? On the mapping screen, choose to group rows that share a product title or SKU, and tick which columns say what differs. Grouping is always off unless you turn it on, because merging two different products by mistake is harder to spot than a duplicate.

Sizes publish to Shopify and WooCommerce as real options a buyer chooses between.

Open this in OneFold →

What is the machine-readable version on my listing?

Search engines and AI assistants look for a block of structured data (schema.org) that states the brand, price, barcode and answers as facts. OneFold builds it from your listing and shows it on the listing page with a copy button.

It never includes a star rating or reviews, because OneFold has none and inventing them is fraud that lands on your shop. It leaves out the price if no currency is set, rather than guessing one.

It is also stored on the product when you publish, but storing is not showing: nothing reads it until your theme prints it on the page. Check your page source first — most themes already publish a Product block, and two blocks describing one product is worse than none.

On WooCommerce, the free OneFold Structured Data plugin prints it for you on every product OneFold publishes. Download it from the machine-readable panel on any listing and upload it under Plugins → Add New → Upload Plugin. By default it adds only the FAQ, so it never duplicates the product block WooCommerce already prints; a setting lets it replace that block instead.

Open this in OneFold →

OneFold suggests products to cross-sell, upsell and bundle. Where a suggestion matches a product already in your account, it tells you which one, so you can link your own products together. Links between your own products help shoppers and search engines understand your range.

It only matches when it is sure. One shared word is not enough, and if two of your products fit equally well it picks neither, because a wrong link sends a shopper to the wrong product.

OneFold does not build or buy links from other websites. Doing that is against Google's rules and the penalty falls on your shop.

Open this in OneFold →

Checks and publishing

What is the pre-publish check?

Your listing measured against the rules of the marketplaces you sell on. Amazon, Etsy, eBay and Shopify: plus EU product-safety requirements.

Anything that would be rejected is shown before you publish, with a one-click fix for everything a machine can repair on its own.

The marketplace checks are useful even where OneFold cannot publish for you: most sellers list on Amazon and Etsy by hand, and finding out why you were rejected afterwards is the expensive part.

What is GPSR and does it apply to me?

The EU General Product Safety Regulation. If you sell physical products to buyers in the EU, every listing must name a responsible person in the EU, carry manufacturer details and show any safety warnings.

These are the same on every listing you make, so OneFold asks once in Settings and applies them everywhere.

Open this in OneFold →

Why can't I publish this product?

Prescription medicines, weapons and explicit counterfeits are blocked outright. Publishing them is a criminal offence in most countries and ends your merchant account, so there is no override.

Regulated-but-legal categories. CBD, nicotine, alcohol, car seats: ask you to confirm you hold the necessary approvals, then publish normally.

If a check is wrong about your product, contact support and we will look at it.

Which stores can OneFold publish to?

Shopify and WooCommerce, as drafts.

Etsy, eBay and Amazon cannot be connected. OneFold can check a listing against their rules, but there is no way to send anything to them.

Plans and usage

What counts against my plan?

Every plan has two different numbers, and they measure different things.

PRODUCTS is how many items your account can hold at once: everything you import from a file, pull in from your store, or create. Holding a product costs nothing, so scoring it, checking it against marketplace and EU rules, and editing it by hand are free and unlimited within that number.

LISTINGS is how many brand-new listings the AI writes for you each month from a photo. That is the part that costs money to run, so it is the part that is metered. On the Free plan you can hold up to 100 products and have the AI write 3 new ones a month. Importing a file uses products, never listings: it calls no AI.

Beyond that, each account has a monthly AI budget for fixes, rewrites and image generation, sized as a multiple of your listing allowance.

Generated images are counted per image, not per click: asking for four variations uses four.

Monitoring costs nothing against the AI budget: it is arithmetic plus one call to your store.

Open this in OneFold →

What monitoring do I get?

Free does not include monitoring. Paid plans monitor a set number of products at a cadence set by the plan, and you can always choose a slower cadence than your plan allows.

Open this in OneFold →

When something goes wrong

My store will not connect

For Shopify, the most common cause is an expired or mistyped Admin API token. They are shown only once, when the app is created. The second most common is a missing scope: the app needs read_products and write_products.

For WooCommerce, use your site's root address rather than a page or the wp-admin URL, and check the API key has Read/Write permission. Some security plugins block /wp-json/ entirely.

Open this in OneFold →

Generation failed or the photo was rejected

OneFold refuses photos that are not of a sellable product: a screenshot, a person, a diagram: rather than inventing a listing for something it cannot see.

If generation fails for another reason, nothing is charged against your allowance and it is safe to try again.

I did not get an email

Check spam first. If a password-reset email never arrives and the page told you it could not send one, that is a problem on our side : contact support from the address on your account.

Open this in OneFold →

Something missing?

If you looked for something here and did not find it, that is useful to know, tell us through the contact page and we will add it.

Common questions

Do I need a connected store to use OneFold?

No. You can make, score and edit listings without one, and export them as Shopify or WooCommerce product CSV files to import yourself.

Does anything go live without my approval?

No. Every listing is sent to your store as a draft for you to review and publish.

What files can I import?

Spreadsheets (CSV or XLSX) and PDF price lists. Each row becomes a listing, and product pictures printed in a PDF are kept with their row.