Products and Currencies
Anything you sell on your site is a content item with a price. You set this up in two places: the currencies you sell in, managed under Commerce, and the Product parts you add to a content type so each item gets a price.
Manage currencies
The currencies you add here are the ones offered in every currency drop-down of the product editors. Add only the currencies you actually sell in. To sell to other countries in their currency without pricing every product again, use Markets, which convert your prices at an exchange rate.
| Menu | Commerce > Currencies |
| Permission | Manage currencies |
| Feature | Products |
What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.
Add a currency
- Open Commerce > Currencies and click Add Currency.
- Enter the Currency code and the Display name.
- Click Save. The message A new currency has been created successfully. confirms it.
| Field | What it does |
|---|---|
| Currency code | The three-letter ISO 4217 code, for example USD or EUR. It is fixed after the currency is created, and each code can only be added once. |
| Display name | The friendly name shown in currency drop-downs, for example US Dollar. Drop-downs show it with the code, such as US Dollar (USD). |
Change or delete a currency
- To rename a currency, click Edit, change the Display name and click Save. The code cannot be changed; to use a different code, add a new currency.
- To remove a currency, click Delete and confirm Are you sure you want to delete this currency? Items that already use the code keep it, but they cannot be saved again until you pick a currency that still exists.
When the list is empty it shows Nothing here! There are no managed currencies at the moment. Use the Search box to find a currency by code or name.
Make a content type sellable
You add the Product part to the content type that describes what you sell, for example Course or Plan. Every item of that type then gets a price. Content types are edited in the browser like any other content setting.
| Menu | Content > Content Definition > Content Types |
| Permission | Edit content types |
| Feature | Products |
What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.
- Open Content > Content Definition > Content Types and edit the content type, or create one.
- Click Add Parts, tick Product, and save. Tick Product prices as well if items should offer more than one way to buy them, such as monthly and yearly, or Product variants if items come in versions such as sizes and colors.
- Back on the content type, click Edit next to the Product part to set its options (below), and save.
Product part options
| Field | What it does |
|---|---|
| Product Type | What kind of thing this is: Undefined, Good, Service or Digital. |
| Default currency | The currency used by items of this type that do not pick their own. Choose from your managed currencies. Without a default and without a currency on the item, the item cannot be sold. |
| Sales mode | Whether items of this type can be bought online: Purchasable (every item can, the default), Listing only (items are listed on your site but never sold online, such as homes) or Per item (each item has a Sell online box). A listed item is still shown, filtered and opened in product listings; it just cannot be checked out. |
| Price display | How the price is shown to visitors: Show the price, Show on request (a label such as Call for price instead of the price) or Hide the price. |
| On-request label | The text shown instead of the price when it is shown on request. |
| Let each product choose how its price is shown | Adds a Price display choice to each item that overrides the setting above. |
The same part's settings also lay out each product's own page and its inquiry button; see Product listings.
Price an item
When you create or edit an item of the type, the Product part adds:
| Field | What it does |
|---|---|
| Price | The selling price, which cannot be negative. Next to it, pick the currency, or leave Use the default currency to use the content type's default. It is required, except for an item that is not sold online and whose price is not shown. |
| Compare-at price | Optional. A was or list price. When it is higher than the price, listings show it struck through with the saving. |
| SKU | Optional. A stock-keeping unit that uniquely identifies the product in your own records. |
| Sell online | Only when the type's sales mode is Per item. Untick it to list the item without selling it online. |
| Price display | Only when the type lets each product choose. How this item's price is shown, or Use the content type's setting. |
| Featured | Marks the product as featured. Listings can filter on it and offer a Featured first sort. |
| Position | Optional. The product's place in a listing's Recommended sort: lower numbers come first, and products without a position come after those with one. |
An item that cannot be bought online is never sold, whatever a visitor tries: no checkout can be started for it.
Offer several prices
The Product prices part adds a Prices section to the item: the ways the item can be bought. A buyer picks one at checkout. A price that recurs makes the item something people can subscribe to; see Subscriptions.
- Fill in the first price. A new item starts with one empty price, marked Default.
- Click Add a price for another one.
- To take a price away, tick Remove this price and save the item.
| Field | What it does |
|---|---|
| Name | What the buyer sees, for example Monthly or Yearly. |
| Amount | The price, with its currency next to it. Default uses the content type's default currency. Cannot be negative. |
| Charged | Charged once or Recurring. Choosing Recurring shows the billing fields below. |
| Every / Interval | Recurring only: how often the buyer is billed, for example every 1 Month. The intervals are Day, Week, Month and Year. Both are required for a recurring price. |
| Cycles | Recurring only: how many times to bill before stopping. Leave empty to bill until the subscription is canceled. |
| Trial days | Recurring only: free days before the first charge. |
| Start after | Recurring only: how many days to wait before billing starts. |
| Setup fee / Setup fee shown as | An extra one-time charge, and the wording the buyer sees for it, for example Onboarding. |
| Default | The price selected first. Only one price can be the default. |
| Offered | Clear it to stop offering the price without deleting it. |
| Buyer names the amount | Lets the buyer enter their own amount, for example for a donation. Minimum and Maximum set the allowed range. |
| Buyer picks a quantity | Lets the buyer buy more than one. Max quantity sets the most they can pick. |
| Offered from / Offered until | Optional dates and times between which the price is offered. Outside them, buyers do not see it. |
If the item cannot be saved, a message under the price says why, for example A recurring price needs a billing interval. or Only one price can be the default.
Sell a product in variants
A product that comes in versions, such as a shirt in three sizes and two colors, is one item with variants: one per combination of its options, each with its own SKU, price and image. Buyers choose a variant before adding the product to their cart, and the cart and the order record the variant they chose.
First, give the content type its options:
- Open Content > Content Definition > Content Types, edit the type, click Add Parts, and add Product variants.
- Click Edit next to the Product variants part.
- Under Options, enter one option per row, such as Size and Color. Tick Filterable for an option visitors can filter listings by. Save; saving offers empty rows for more options, and clearing a name removes that option.
Then, on each product:
- Under Variants, enter the values of each option, separated by commas, such as S, M, L, and save. The product gets one variant per combination, such as S / Red.
- In the table that appears, fill in each variant you want to differ from the product:
| Field | What it does |
|---|---|
| Sold | Untick it to stop selling a variant without losing it, for example while it is out of stock. |
| SKU | The variant's own SKU. Leave it empty to use the product's. Each variant's SKU must be different. |
| Price | The variant's own price. Leave it empty to sell it at the product's price. |
| Compare-at price | A was price for the variant. |
| Image | Which of the product's own photos the variant shows. Add every photo to the product's images and save first, then pick one per variant. |
When you change the values later, a variant keeps its SKU and prices while its combination stays; combinations you remove are dropped. When the content type gains an option, each variant carries on as the first combination that matches it: an M shirt becomes M / Red with its SKU and price, and M / Blue is new. When the type loses an option, the first variant of each remaining combination carries on.
In listings, a product whose variants are priced differently shows From its lowest price, a filter on an option finds the product when any variant on sale has that value, and keyword search matches the variants' SKUs. On the product's card and page, Add to cart offers one list per option, such as Size and Finish. A value that makes no variant on sale with the others picked can't be chosen. On the product's page, the price, the SKU and the photo change to the chosen variant's. Without JavaScript, a single Choose list of the variants on sale, with their prices, is offered instead.
Put a product on sale
On the product's editor, enter a Sale price and, optionally, when the sale runs under Sale runs, in your site's time zone. During the sale the product sells at the sale price, with its regular price struck through, on its card, its page and in the cart. Listings switch to and from the sale price within a minute of the times you set. Leave the dates empty for a sale that runs until you clear the sale price. A variant can have its own sale price in the variants table.
Quantities, volume discounts and role prices
Under Quantities and volume pricing on the product's editor:
| Field | What it does |
|---|---|
| Quantity | At least, At most and In packs of: how many a buyer can put in their cart, such as at least 2, or in packs of 6 for a six-pack. The quantity box on the product starts at the least and steps by the pack. |
| Volume discounts | Up to four rows of From quantity and % off each, such as 10% off each from 5. A buyer gets the best one they reach, and the product's page lists them. |
| Role discounts | A role and a percentage, such as 20% off for Wholesale. Signed-in buyers in the role see their price note on the product and pay it in the cart. |
A buyer gets the best of their role and volume discounts, not both. The cart says so when a quantity breaks the product's rules and asks for one that doesn't.
Let buyers personalize a product
Under Personalization, Add-ons lists the personal touches a buyer can add, such as an engraving or gift wrap. For each, enter a Label, choose whether the Buyer types a text or ticks a box, an optional Extra price, what it's Charged on (every unit, every person a unit is for such as a room for two, or a percent of the price such as insurance), and whether it's Required. Clear a label to remove an add-on.
Buyers choose add-ons on the product's page. A card of a product with a required add-on shows Choose options, which opens that page. The same product with other add-ons is another line in the cart, and the add-ons show on the cart, the checkout, the order and its emails, and the packing form.
Sell a product somewhere else
To list a product sold elsewhere, such as on a partner's store, enter its address under Sold elsewhere and, optionally, the button's label. It isn't sold on your site: its card and page show your button, which opens that address in a new tab, in place of Add to cart.
Group products on one page
With the Grouped Products feature, a product can show several products on one page, such as the pieces of a set, each with a quantity, and one Add to cart adds the ones the buyer chose. On the product's editor, pick them under Products in this group, and leave the product itself without a price: the products in it are what's bought. A product in the group that has a variant, a price or a required add-on to choose links to its own page; one sold elsewhere links there. The group's card shows Choose products.
Sell a bundle or kit
With the Product Bundles feature, a product can be a bundle of other products, such as a starter kit of two caps and a tee, sold at its own price. Under Bundle on the product's editor, choose each product in it under Made of and how many each bundle holds. The bundle's page lists what's in it.
Its stock is what its parts in stock can make: with 4 caps left and 2 in each kit, it shows Only 2 left. Selling a bundle takes each part from stock, and canceling or refunding the order puts them back. Don't count the bundle's own stock. A part can't be sold in variants or be a bundle itself.
Import and export products
Products import and export like any other content, with the Content Transfer feature (Content > Bulk Import and Bulk Export), in a CSV file or, with its OpenXml feature, an Excel workbook.
Each product is a row, and its product details are columns: the price, compare-at and sale prices with the sale's dates, SKU, currency, the address of a product sold elsewhere, quantity rules, the options and variants, the category and brand by name, and the stock. Download a template from the import page to see them all. An export has the same columns, so you can change prices in a spreadsheet and import the file back.
Rows are matched to your products by SKU, the product's own or a variant's, so an import doesn't add a product twice:
- A row whose SKU is already in your store updates that product when the file has the ContentItemId column, as an export has. Without that column, the row is skipped and the import says why.
- A row whose SKU an earlier row of the file used is skipped, with the row it repeats.
To move from another store, export your products from Shopify (Products > Export) or WooCommerce (Products > Export) and import the file as your product type. It's read as it is:
- Variants come in when the type has the Product variants part with options of the same names, such as Size. Otherwise the product comes in as one product, from its lowest price, with the stock of all its variants.
- Categories and brands go to the type's taxonomy fields named like Category and Brand, matched to their terms by name.
- A product already in your store, matched by its SKU, a variant's SKU or its address, is updated.
- Images aren't downloaded. Add product photos in the media library.
To charge tax on a product, add the Taxation part to the same content type. See Taxes.