Skip to main content

Merchandising

Managing Products: the List, Bulk Actions and the Product Editor

Find, select and change many products at once, and what each section of a product's edit page does — including seeing it in your store, its marketing assets, and where it is posted and listed.

Overview

Catalog → Products lists your products, a page at a time. Click a product to open its edit page. To add products, see Getting Started → Add your products (manual entry, CSV import or a connected store).

Products and bulk actions are part of every plan.

The Import menu at the top of the list holds both importers:

  • Import from CSV takes any spreadsheet or a Shopify export. You match your columns to ours and see a preview before anything is saved.
  • Re-upload an Export file takes a file made by Export, after you have edited it, and imports it straight away. It reads our own column names, including pricecents (the price in cents, so 1999 is 19.99); a row without a price there is skipped and listed as an error, so use Import from CSV for any other file.

Both say, when it applies, how many imported products cannot be sold yet on a storefront that charges in a different currency from your store currency, and how to fix it (Storefront prices).

Categories and Collections beside it open your category tree and your collections.

Putting a product on your store

Each product card on the list has Publish to store. It makes the product visible on every one of your storefronts, and the button then reads Live on store, or On store · not live yet while the store itself is not live; click it again to hide the product from them. A product needs a price above zero first, and a storefront where you set the product's own price keeps that price. On a storefront that charges in a different currency from your store currency, a product that follows the product price is not published, and you are told which storefront and how to fix it; see Storefront prices.

It works on a store that is not live yet, so the product shows in your store preview straight away (see Going live). Shoppers see it once the store itself is live.

Scheduling a launch or an end date

Under Status on a product's edit page, Publish at puts a product on sale at a time you choose, and Unpublish at takes it off sale. Times are in your store's time zone (the one your storefront is set to, shown under the boxes), so a launch set for 9:00 happens at 9:00 where your store is, even across a clock change.

  • To schedule a launch, set the status to Draft, choose Publish at, and save. You confirm the listing is lawful to sell when you save, as you would when publishing it yourself. A product that is live, or being put live, cannot also carry a launch time: set it to Draft first, or clear the time.
  • At the publish time the product goes through the same checks as publishing it yourself, usually within a minute. If the automatic check holds it, it waits for review, as it would have if you had clicked Save. A listing that was rejected in review is not published.
  • If what shoppers would see changes after you schedule (the name, description, category, tags, photos or videos), you confirm again when you save, and that is the version that goes live. If the product was changed some other way, such as an import or the API, it stays a draft at the publish time.
  • At the unpublish time a live product goes back to Draft. It keeps everything else, so you can put it back on sale whenever you like.
  • Each time is used once. After it has been acted on, the box is empty again. Unpublish at must be after Publish at, and a time you set must be in the future.
  • If a scheduled launch does not happen (it was rejected, changed since you confirmed it, or its unpublish time had already passed), it stays a draft and you get a notification saying why. Every change made on schedule is in Settings → Audit log, marked as made by the schedule.

The product appears on the storefronts it is published to (see Putting a product on your store), so publish it to your store while it is still a draft and it is ready to appear at the launch time.

Changing many products at once

Tick the box on a product's photo, or Select all on this page, and a bar appears above the list:

  • Status — set the selection active, draft or archived. Setting products active asks you once to confirm they are lawful to sell, and the automatic checks in Listing review below apply, exactly as one at a time.
  • Price — change by a percentage (−20 is 20% off), by an amount, or set one price, with optional rounding (end in .99, .95, .00, or a whole amount). Each product's new price is worked out from its price now; a result below zero is held at zero and reported.
  • Tags — add or remove tags.
  • Collection — add to or remove from a collection you pick by hand. (Collections made by rules decide for themselves; see Collections.)
  • Social channels — where the products may be posted: your store's networks, only the ones you pick, or never.
  • Product feeds — which shopping feeds they appear in: every feed you have on, only the ones you pick, or none.
  • Tax category — what the products are, for tax (see Tax categories below).
  • Customs — the HS code, country of origin and CUSMA choice a label to another country declares. Fill in any of them; a box left empty keeps each product's own value, and a value no customs office reads is refused before anything changes (see Shipping across a border).
  • Print labels — barcode and price labels for the selection, on an Avery sheet or a thermal label printer (see Barcode and price labels below).

Up to 500 products at a time. If some did not change, the bar lists which and why; the rest are changed.

When the list has more products than one page shows, Select all next to Select all on this page selects every product in the list, on every page (for example, every product in a category). With more than 500 in the list it says so instead of selecting some of them: narrow the list first.

To change every product in a collection, open the collection under Products → Collections and click Change these products. The products list then shows only that collection (a hand-picked collection's products, drafts included; a rule-based collection's products that its rules pick now), and Select all … in that collection selects all of them for the bar. Clear the filter with the button beside the collection's name.

Collection needs the Owner, Admin, Manager or Staff role, the same as changing a collection on its own page. Print labels changes nothing, so every role that can see products has it. The other actions change a whole selection at once, so they need the Owner, Admin or Manager role; the bar shows only the actions your role can use.

Bulk edit

Catalog → Bulk edit opens your products in a grid you edit like a spreadsheet: one row per product, and one row under it per variant. Open it from the menu (your whole catalogue, when it has up to 500 products), from Bulk edit at the top of the products list (the list as it is filtered, by category or collection), or tick products and click Bulk edit in the bar above the list (just those).

Each row shows the name, SKU, barcode, price, compare-at price, cost, stock, weight, status, tax category and shipping class. A variant row shows its options instead of a name, and its name, status, tax category and shipping class come from its product. Prices are in your store currency.

  • Moving around: click a cell, or use the arrow keys; Tab moves right and Enter moves down. Hold Shift with the arrows, or drag, to select several cells.
  • Changing a value: start typing to replace it, or press Enter (or double-click) to edit it. Escape leaves it as it was. Delete empties the selected cells.
  • Pasting from a spreadsheet: copy a column or a block of cells in your spreadsheet, click the first cell to fill, and press Ctrl+V (Cmd+V on a Mac). It fills down and to the right; one value pasted over a selection fills the whole selection. Ctrl+C copies the selected cells back out.
  • Fill down: select a column of cells and press Ctrl+D, or click Fill down: each takes the value of the top cell.
  • Undo: Ctrl+Z, or the Undo button, takes back your last change, as many times as you need, until you save. Redo puts it back.

Changed cells are highlighted. A value that cannot be saved (a price of zero, a stock count with a fraction, a tax category that does not exist) is marked in red with the reason, and has to be fixed before you can save. Cells you cannot change are greyed, and say why when you point at them or start typing in them: the stock of a product with variants is the total of its variants, a gift card's price comes from its amounts, and an affiliate product has no stock.

Stock at locations. When you keep stock at locations (Catalog → Inventory, see Buy online, pick up in store), the grid adds a stock column for each one. For an item with stock at locations, its total is read-only and you change the location columns. An item whose stock is not yet split across your locations is fixed from Inventory first.

Saving. Click Review changes to see every change, with its value before and after, then Save. Each row is saved exactly as one edit in the product editor would be: putting a listing live, or renaming one that is live, asks you once to confirm the listings are lawful to sell (see Listing review) and goes through the same checks; the change is in Settings → Audit log with its old and new values; and your storefront prices and search are updated. A stock change is recorded in the product's stock history with the reason Bulk edit, and reaches your connected sales channels as any stock change does.

A row is not saved if someone else changed it since you opened the grid, or if its stock moved in the meantime (a sale, for example), so nobody's change is overwritten without being seen. The rest are saved, and a list above the grid names each row that was not and why: click it to go to that row, then Reload to see what it holds now and make your change again. Rows are saved in batches, and the grid shows how far it has got.

Up to 500 products, and 2,000 rows counting their variants, open at a time. A list with more than 500 products asks you to filter or select first, and when variants take the grid past 2,000 rows it says how many products were left out. Anyone who can see products can open the grid; saving needs the Owner, Admin or Manager role, like the other actions that change many products at once.

Barcode and price labels

Print labels for your shelves and products, with a barcode your till and your stock counts can scan. Labels are part of every plan.

Where to print them from:

  • The products list — tick products and click Print labels in the bar above the list. Choose one label for each product (a product with options gets one for each option), or one for each unit in stock now.
  • A product's edit page — Print labels at the top right. It prints what is saved, so save first if you changed the price, SKU or barcode.
  • Purchase orders — after you receive stock, Print labels for received items prints one label for each unit that just came in. A part delivery prints labels for that delivery only, not again for what came in before. A received order's details also have Print labels for everything received on it so far. Lines that are not tied to a stock item have no label.
  • Stock transfers — the same at the destination: Print labels for received items after you receive, and Labels at the top of a transfer for everything received on it.
  • Your label queue — any of these can Add to label queue instead of printing straight away. Catalog → Barcode labels shows your queue: change how many labels each item gets, remove an item, and print them all in one go. The queue is yours alone (a colleague building a print run at the same time has their own), it is kept after you print, and Clear queue empties it. Adding an item that is already queued adds the labels together.

Label stock. Avery 5160 prints 30 labels of 2-5/8" × 1" on a US letter sheet, on any office printer; fill in Labels already used on the first sheet to start part way down a sheet you used before. Thermal 2.25" × 1.25" prints one label per page, for a Zebra or DYMO label printer. Print at actual size (100%), with no margins and no headers and footers, or the labels will not line up. Download PDF saves the same sheet as a file.

What each label shows: the product's name (shortened to fit), its option, its price in your store currency, a barcode, and its SKU. The price is the one your store and your till charge: an option's own price when it has one, otherwise the product's price. The barcode is:

  • the barcode you entered for the product or option, when it is a UPC-A (12 digits) or an EAN-13 (13 digits, which includes an ISBN-13) and its check digit is right;
  • otherwise a barcode of the SKU (Code 128), which the till and stock counts scan the same way. An option without a barcode of its own uses its own SKU, never the product's barcode, so scanning it rings up that option.

A barcode whose check digit is wrong is never printed, and nor is one of another length (an 8-digit EAN-8, for example). The print view lists each item it could not print as asked, and why, above the sheet; that list is not printed. An item with no usable barcode and no SKU prints with No barcode on it: add a barcode or a SKU to the product to fix it. Gift cards print without a price, and products sold and shipped by someone else have no shelf label.

Flash sale prices are off unless you ask for them. On a plan with flash sales, tick Print flash sale prices where a sale is on now to print the sale price, with the regular price struck through, for products in a sale that is running. The print view says when each sale ends, so you can print regular labels for then.

Scanning them. The till and stock counts find a UPC-A whether your scanner sends it as 12 digits or 13, and the till's search finds a product by its barcode or by an option's barcode or SKU, not only among the products already on screen.

Anyone who can see products can print labels and keep a label queue, including the read-only Viewer role.

The product editor

The edit page is in sections; the menu on the left jumps between them. Most are self-explanatory (basics, pricing, variants, inventory and shipping, description, SEO, specifications). A few worth knowing:

  • Product type — Physical, Digital, Service or Gift card, at the top of Basics (and when you Add product). The sections change with it: a gift card shows Gift card amounts instead of a price, stock, shipping and variants. A product that has been ordered cannot become a gift card or stop being one. See Gift cards.
  • Stock — a number you type over a product's or a variant's stock is recorded as a change, from the old number to the new one, with the reason Product editor, and listed in the product's recent stock changes on the Inventory page. An import that changes a stock number records it the same way, with the reason CSV import or Product import. Saving the same number records nothing. A product with variants holds the total of its variants, so you change the variant rows; removing a variant takes its stock out of that total straight away.
  • Print labels (top right) prints barcode and price labels for the product, or for each of its options. See Barcode and price labels.
  • Open in store (top right) opens the product's real page in your store. If your store is not live yet, it opens as a private preview. It also tells you if a shopper would not see the product yet, and why — it is waiting for review, hidden on that store, or has no price there. Quick preview shows a quick look inside the dashboard without opening your store.
  • Photos — each photo is prepared when you upload it: turned the right way up, resized to at most 2,400 pixels on its longest side (3,000 for jewellery, watches and art; 2,000 for food and bulk goods), saved as a WebP file, and stripped of hidden details such as where the photo was taken and which camera took it. A transparent background stays transparent. Your store then shows each shopper a size that fits their screen. To use an image you already have, click Library beside the upload button, on the edit page or when you Add product: it comes from your media library as it is, without being uploaded again. A new photo has to be one of your own uploads or library images, and a video can't be a product photo; photos a product already has, such as an imported product's, stay as they are. The first photo is the cover.
  • Photo descriptions (alt text) — under the photos, one box per photo for what it shows, for example "Blue linen shirt, front, on a hanger". A screen reader reads it to a shopper who cannot see the photo, and search engines use it. It is saved with the photo in your media library, so a photo used on two products reads the same on both, and changing it in either place changes both. A photo left empty is described in your store as the product's name and its number ("Blue linen shirt – image 2 of 5"). The SEO metadata tool in Image Studio suggests a description: Use as this photo's description puts it in the box, for you to check before you save. A photo linked from another site (some imported products keep their source's addresses) cannot hold a description; upload a copy to describe it. Descriptions are in one language, as you type them: translations do not carry them.
  • Image studio — the palette button on any product photo opens it: remove backgrounds, watermark, brand and campaign versions, infographics, platform sizes, social posts and video ads. See Image Studio.
  • Marketing assets — everything the image studio made for this product, kept here after the studio closes: open it, copy its link, add it to the product photos, or take it off the list.
  • Social — where this product may be posted, and a quick composer to post it now. See Social Media.
  • Marketplace identifiers → Product feeds — which shopping feeds this product appears in. See Product Feeds.
  • Translations — the product's name, description and web address in each language your store sells in.
  • Tax category — under Pricing & promotions, what the product is for tax. See Tax categories.
  • Unit price — under Pricing & promotions, for goods sold by weight, volume, length or count. See Unit price.
  • Policy override for this product — under Lifecycle, gift wrap, returns: mark a product non-returnable and add a note. Both show on the product's page in your store, in the Returns section, and a non-returnable product no longer shows a return window there.
  • Canadian origin claim — under Compliance & customs, a "Product of Canada" or "Made in Canada" claim you make about the product. See Product of Canada and Made in Canada.

Nothing is saved until you press Save changes at the bottom of the page.

Tax categories

Every product is taxed as General goods until you say otherwise. Some goods are taxed differently: in Canada basic groceries, prescription drugs and some medical devices are zero-rated, and several provinces take their part of the tax off children's clothing and footwear and printed books. Pick the product's Tax category in the product editor or when you Add product:

  • General goods — taxed at the full rate. Most products.
  • Basic groceries — food for home consumption.
  • Prepared food — ready-to-eat meals and heated food.
  • Children's clothing & footwear — in children's sizes.
  • Printed books — bound printed books.
  • Prescription drugs
  • Prescribed medical devices — devices on the zero-rated list, such as hearing aids and mobility aids.
  • Digital services & downloads
  • Professional services
  • Not taxable (exempt) — no tax is charged on it, anywhere.

What the category does depends on how your store works out tax:

  • With Stripe Tax on, each product is sent to Stripe with its category's tax code, so Stripe applies the rules of the place it is sold to. Nothing else to set up.
  • With your own tax rules, a rule charges its own rate on every category until you give it a rate for that category, under Tax rules → Category rates (basic groceries at 0%, say). Not taxable (exempt) is the exception: it is never taxed unless a rule names a rate for it. The tax rules page warns you when products are in a category none of your rules sets a rate for. See Tax with your own tax rules.

The category is used everywhere an order is taxed: checkout, the cart's estimate, draft orders, the point of sale, exchanges and order edits. A gift card is never taxed when it is sold, whatever its category.

To set the category of many products at once, select them and use Tax category in the bar above the list. A CSV export has a taxCategory column, and importing a file with that column sets each product's category: leave a cell blank for general goods, or use one of groceries, prepared_food, childrens_clothing, books, prescription_drugs, medical_devices, digital_services, professional_services or exempt. A row with a category BestWebby does not know is skipped and listed, so a typo never changes what a product is taxed at. On the Import products page, match your column to taxCategory under Map columns; there a blank cell leaves the product's category as it is.

The category is separate from the Tax class, which picks which of your tax rules apply to a product (a rule written for your own "reduced" class, for example). A category then sets the rate those rules charge.

Unit price

For goods sold by weight, volume, length or count, your store can show what they cost per a set amount, such as "$1.20 / 100 g", under the price. In the product editor, under Pricing & promotions → Unit price:

  • Amount in the pack and its unit — what one item holds, for example 500 and g.
  • Show the price per and of — the amount the price is shown for, for example 100 (of the same unit unless you pick another of the same kind, such as kg). It is a whole number from 1 to 1,000.

The units are g, kg, mg, mL, cL, L, m, cm, m², each (items in a pack), oz, lb and fl oz. Grams can be shown per kilogram, but not per litre: the two units must measure the same thing.

The unit price is worked out from the price the shopper is seeing at that moment, so a flash sale, a storefront's own price or a pricing rule changes it too. It shows on the product page, on product cards (the products list, collections and the page builder's product sections) and on each line in the cart. A gift-wrapped cart line shows none, because its price includes the wrap.

An option can hold its own amount, such as a 1 kg bag beside the 500 g one: with a unit price set, the variants table has an Amount column. Leave it empty for the product's amount. Every option is shown per the product's amount, so they compare like for like. Turning unit pricing off clears the options' amounts when you save.

Your Google and Meta product feeds carry the same terms (unit_pricing_measure and unit_pricing_base_measure), and the channel works the unit price out from the feed price.

A CSV export has unitMeasure, unitMeasureUnit, unitBaseMeasure and unitBaseUnit columns, and both importers read them back. Leave unitMeasure empty to switch unit pricing off; a cell such as "500 g" there is read as the amount and its unit. On the Import products page, match your columns under Map columns (Shopify's "Unit Price Total Measure" columns are matched for you). A row whose terms cannot be read is skipped and listed. The API takes the same four as unit_measure, unit_measure_unit, unit_base_measure and unit_base_unit.

Which products need a unit price, and how it must be shown, depends on where you sell. BestWebby shows the terms you set; check the rules that apply to your store.

Selling by weight or measure

Cheese by the kilo, rope by the metre, oil by the litre: a product can be sold by an amount instead of by the item. Open the product and, under Pricing & promotions → Sold by, choose Weight or measure, then set:

  • Unit: kg, g, lb, oz, L, mL, m or cm. The base price is then the price of one unit ("$12.99 / kg"), and so is each storefront's own price.
  • Smallest amount and Step: what a shopper can buy online, for example from 0.100 kg in steps of 0.005 kg. The smallest amount must be a whole number of steps.
  • Largest amount (optional): the most one order line can take, online and at the till.
  • Packs (optional): amounts the product page offers as buttons, such as 0.25 | 0.5 | 1. Each must fit the rule. Without packs the shopper picks an amount with a stepper or types one.

Shelf and barcode labels print the price per unit, such as $12.99 / kg, and a delivery prints one label for the product, not one per unit of weight. Amounts have at most three decimals.

Stock in the unit. Stock of a measured product is shown and typed in its unit everywhere you work with it: the products list, the product editor and its quick edit, Bulk edit (the stock and location columns), Inventory and its adjust box, Stock by location, stock counts, transfers and their packing slips, purchase orders and receiving, restock suggestions, the at-risk stock on your overview and the low-stock notice. 12.5 kg on hand reads 12.5 kg, and you type 12.5 (or 12,5). A number like 1,240 is refused rather than guessed at, because it could mean 1240 or 1.24; write 1240 or 1.24. Behind the scenes it is kept in thousandths of the unit (12500 for 12.5 kg), which is what the API sends and takes.

Totals add like with like: a line of 2.5 kg and a line of 3 mugs read "3 units · 2.5 kg", and the units figures on Inventory and on a count's review leave kilograms out (their cost is still counted, at the cost per unit of measure). Reorder at and Reorder quantity are in the unit too (5 for 5 kg), and so is the low-stock threshold on Inventory. A measured product runs low at 5 of its unit, so the low-stock notice for a cheese says "4.5 kg left" when it drops under 5 kg. A product's cost is per one unit, like its price: a purchase order line of 25.5 kg at $8.00 costs $204.00.

Stock counts weigh rather than count: scanning a measured product asks for the amount weighed, the line's + and − are not offered, and you type the amount on the line instead. Supplier returns count units, so they do not take a measured product yet; take the amount off with Inventory → Adjust.

How the price is worked out. The line costs the price of one unit times the amount, rounded once to the cent, half up: 1.235 kg at $12.99 / kg is $16.04. Checkout, the cart, the till and every quote use the same rule, and only the amount travels from the shopper's cart; the price is always read again from your catalogue. The order line keeps the amount, its unit and the price per unit, and the order page, packing slip, emails, receipts (the till's, printed or emailed, and the one shoppers print from their account), the orders export and the API show it as 1.235 kg @ $12.99/kg. Papers without prices show the amount alone, such as 1.235 kg: the gift receipt, the pickup hand-over, the delivery run and the driver's stops, and the cart reminder email.

On the order:

  • Discounts in percent work as on any line. An amount off per item comes off the measured line once, and an offer that counts items (buy 2, get 1) counts a measured line as one. A measured product is never part of a bundle.
  • Tax is worked out on the line's price, like any other line.
  • Item fees (eco fees, deposits) charged per item are charged once per measured line.
  • Shipping weighs a line sold by weight at its amount; for litres and metres, set the product's weight per unit and it is multiplied by the amount.
  • Stock comes off in thousandths of the unit, and checkout refuses an amount you do not have, unless the product allows backorders or does not track stock.

Refunds are by the amount. On the order, Refund shows each measured line as "0.835 kg of 1.235 kg left to refund"; type the amount to refund, such as 0.400. Each part is refunded at its share of the line's price, discount and tax, and all the parts together come to exactly what the line was charged. Before the line ships, the amount refunded is taken off what ships and can go back in stock; once it has shipped, tick Put back in stock only if the goods came back. The returns form and returns at the register do not take a measured line: refund the amount from the order instead.

What a measured product cannot have, because each counts by the item: options, Subscribe & Save, a case pack, minimum and maximum quantities (the smallest and largest amount replace them), lot or serial tracking, gift wrap, a unit price label (it is priced per unit already) and auctions. The save refuses each by name, and the editor hides most of them. Checkout does not take an offer's agreed price for it. Agent checkouts and UCP sessions (the buyer chooses the amount on your own checkout), marketplace listings, draft orders, B2B draft orders and company orders on account, layaways, exchanges and order edits refuse it and say why. Product feeds leave it out. A company price list can still give it its own price per unit, without a pack size or quantity break.

Changing how a product is sold. Units and amounts are counted differently, and nothing converts one into the other. So a product changes between The unit and Weight or measure only while its stock is 0 at every location and no order that can still ship or be refunded includes it; to sell it by weight it must also have no subscriptions, be in no bundle and be listed on no marketplace. Set the stock to 0, change it, then count the stock again. For a product with sales still open, add a new product sold the other way.

In bulk. A CSV export has soldBy (unit or measure), measureUnit, measureMin, measureStep, measureMax and measurePacks (amounts in the unit, packs separated by |). Both importers read them back as a group; a row whose rule cannot be read, or that would switch a product with stock on hand, is skipped and listed. The stock column of a measured product is its amount in the unit (12.5 with kg in measureUnit). On import, a measured product's stock is read in the unit its row names in measureUnit; a row that gives stock for a measured product without naming its unit is skipped and listed, never guessed at. The same rule holds for a stock-count file: give the amount in the unit and the unit in a Unit column. Rows for products sold by the unit read exactly as before, with the unit blank. Through the API, the fields are sold_by, measure_unit, measure_min, measure_step, measure_max and measure_packs, and an order line carries measured_amount, measure_unit and measure_price_cents. At the till, see Point of sale.

Product of Canada and Made in Canada

You can show Product of Canada or Made in Canada on a product's page. It is a claim you make, and you are legally responsible for it: BestWebby shows it exactly as you state it, never checks it, and never sets it for you. It is not taken from the product's country of origin, which is for customs and answers a different question.

The Competition Bureau's guidelines set the test:

  • Product of Canada — the last substantial transformation of the product happened in Canada, and at least 98% of the total direct costs of producing or manufacturing it are Canadian.
  • Made in Canada — the last substantial transformation happened in Canada, at least 51% of the total direct costs are Canadian, and the claim carries a qualifying statement, such as "Made in Canada with imported parts".

To make a claim, open the product, go to Compliance & customs, and choose it under Canadian origin claim. For Made in Canada, type the words that follow it in Qualifying statement (for example "with imported parts", up to 80 characters); the editor shows what shoppers will read. Then tick the confirmation that the product meets the test. A new or changed claim is not saved without that tick, and the product records who confirmed it and when. Choosing No claim takes it off; that needs no confirmation. Every change, and every removal, is in Settings → Audit log with the old and new claim.

Shoppers see one line on the product page, in your words: "Product of Canada", or "Made in Canada" followed by your statement exactly as you typed it. In French the claim reads "Produit du Canada" or "Fabriqué au Canada", followed by your statement as typed. Your store's product listing and search get a Canadian products filter once at least one product makes a claim.

Food is different. Origin claims on food follow the Canadian Food Inspection Agency's rules, not these. A product whose tax category is Basic groceries or Prepared food cannot carry either claim here, and a product that carries one cannot be moved to a food category until you remove it. You can still describe where your food comes from in its description.

In bulk. A CSV export has originClaim, originQualifier and originClaimAttested columns. In a file you import, originClaim is product_of_canada, made_in_canada or blank for none, and originQualifier holds the qualifying statement. A row that sets a new or changed claim is saved with it only when originClaimAttested says yes; otherwise the product is saved without the change and the import lists it with the reason. A claim imported unchanged asks for nothing. On the Import products page, match your columns to originClaim, originQualifier and originClaimAttested under Map columns; there a blank cell leaves the product's claim as it is. Column names ignore capitals, spaces and underscores in both imports, so Origin Claim or origin_claim reads as originClaim. Store syncs and supplier feeds never set or remove a claim.

Through the API, the fields are origin_claim, origin_qualifier and origin_attested_at; see the API reference.

Age-restricted products

For products only older customers may buy, such as alcohol, tobacco, vapes or some blades, set a minimum age. Open the product, go to Compliance & customs, and choose the age under Age-restricted, from 16 to 21 or older. No minimum age takes it off. Every change is in Settings → Audit log with the old and new age.

You decide which products need an age and which age. The rules differ from place to place, and you are responsible for knowing and following the ones where you sell. BestWebby asks for the confirmations below and records them; it does not check anyone's ID for you, and the setting does not make a sale lawful on its own.

Once a product has a minimum age (19 in these examples):

  • Product page: shows 19+ only, with a line saying the shopper confirms their age at checkout. The wallet buttons on the product page and the subscribe option are not offered for it.
  • Cart and checkout: the shopper ticks I confirm I am 19 or older (the highest age in the cart) before paying: on the cart page, which then shows the wallet buttons, or at checkout. The box is never ticked for them, and checkout refuses the order without it, for a company buyer paying on account too. The order records the age and the time it was ticked.
  • Point of sale: the till asks the cashier to check ID when the item is added. See Point of sale.
  • The order page shows Age-restricted: 19+, who confirmed it (the shopper at checkout, or the cashier at the till) and when.
  • Packing slip: prints Age 19+: check ID on delivery, or at pickup for an order collected in store. The pickup hand-over and the driver's page for a local delivery show Check ID: 19+.
  • Shipping labels: for an order with age-restricted items, the Ship dialog's Adult signature on delivery is ticked, and the label asks the carrier for an adult signature. Carriers charge extra for it, and a carrier that does not offer it refuses the label: untick it to buy without. Labels bought in bulk ask for it too.
  • Agent checkouts: an agent cannot confirm a person's age, so the agent checkout and UCP sessions refuse a basket with an age-restricted item and send the buyer to your store's own checkout.

In bulk. A CSV export has a minimumAge column: 16 to 21, or blank for none. Importing a file with that column sets each product's age, and a blank cell takes it off; a row with any other value is skipped and listed. On the Import products page, match your column to minimumAge under Map columns. Through the API, the field is minimum_age; an order carries minimum_age, age_checked_at and age_checked_by.

Listing review

Your products go live as soon as you save them. Nobody at BestWebby has to approve them first.

  • You confirm each listing is lawful to sell. When you add a product, publish one, or change what shoppers read or see (the name, description, category, tags, photos or videos), you tick a box confirming you have the right to sell it, that it is lawful everywhere you sell it, that you hold any licence needed, and that the description and photos are accurate. A price, stock or shipping change never asks.
  • Each confirmation is recorded with who confirmed, when, which version of the text, and exactly what the listing said at that moment. This applies to the bulk bar, CSV import, the API, and showing a partner item in your catalogue too.
  • A few automatic checks still apply. A listing that names something not allowed (counterfeit goods, for example) is refused with the reason. A listing is held for a quick check when a photo matches one removed before, or when the automatic check is confident it shows something not allowed.
  • The automatic check finishes a few minutes after you save, so it can take a listing that is already live off sale. When it does, you get an email and a notification naming the kind of problem (a designer logo in a photo, for example), and the product editor shows the same message for as long as the listing is held.
  • To fix a held listing, change what the check found (replace a photo of a different product, or reword a health claim) and save: the title, description and photos are checked again straight away. Otherwise a person reviews it and you are emailed the outcome.
  • A photo that shows a different product (a necklace on a ring listing, for example) does not stop a listing selling. The check leaves you a notice in the dashboard so you can replace the photo before shoppers notice.
  • A listing found to break the rules is removed, and repeated breaches can lead to the account being suspended.