Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Documentation edits made through Mintlify web editor
mintlify[bot]96c354bfe2d9
diff --git a/docs/user/products/creating-products.mdx b/docs/user/products/creating-products.mdxindex 19b20b76e3..435a1a8bcc 100644--- a/docs/user/products/creating-products.mdx+++ b/docs/user/products/creating-products.mdx@@ -3,9 +3,9 @@ description: "How to Create a Product in Spree Commerce open-source eCommerce pltitle: "Create a Product"----In this article, you will learn how to create a new product, categorize it, and make it active on the storefront running on Spree Commerce open-source eCommerce platform.+In this article, you will learn how to create a new product, categorize it, and make it active on the storefront running on Spree Commerce [open-source eCommerce platform](https://spreecommerce.org/).-If your using Spree Enterprise Edition and have hundreds or thousands of products to upload, then it may be more convenient to do it in bulk by using our CSV importer. To learn more about product imports, please refer to this support article: \{\{LINK TO PRODUCT IMPORTS}}+If your using Spree Enterprise Edition and have hundreds or thousands of products to upload, then it may be more convenient to do it in bulk by using our CSV importer. To learn more about product imports, please refer to a separate support article.Important: After you’ve filled out all of the relevant fields for your new product, make sure to click the blue Create button at the bottom of the page, otherwise all progress will be lost if you navigate away from the page.@@ -13,17 +13,17 @@ Important: After you’ve filled out all of the relevant fields for your new proTo add a new product, navigate to the Products tab of the admin dashboard and click “+ New Product”.-IMG+<img alt="Add A New Product" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759783/docs/Products/Create%20a%20Product/2.1.1.1_Creating_Products_-_Add_A_New_Product_yptrme.png" />This will open the product editor where you can begin creating a new product.-IMG+<img alt="Product Editor" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759783/docs/Products/Create%20a%20Product/2.1.1.2_Creating_Products_-_Product_Editor_fgyubi.png" />## Add a Name & DescriptionFirst of all, enter a name for the product and preferably a description to help customers learn more about the product.-IMG+<img alt="Name And Description" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.3_Creating_Products_-_Name_And_Description_ikb2wn.png" />### Name@@ -39,19 +39,19 @@ The editor allows you to format the description with standard formatting optionsThis is where you can add visual media to the product.-IMG+<img alt="Media" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.4_Creating_Products_-_Media_ntcydu.png" />Simply click on the + icon and select the file(s) you’d like to upload.-IMG+<img alt="Select Files" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.5_Creating_Products_-_Select_Files_laoyqi.png" />Once added, you can rearrange the images by clicking on the 6 dots in the top right corner of an image and dragging and dropping, with the left-most image being the main image that’s displayed on PLPs, and the order of the remaining images affecting the order in which they are presented on the PDP.-IMG+<img alt="Order of Images" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759784/docs/Products/Create%20a%20Product/2.1.1.6_Creating_Products_-_Ordering_Images_asnylp.png" />If you’d like to remove an image, then you can either check the box in the upper left corner and click Delete Selected, or click on the image itself, click Delete, and then click Save.-IMG+<img alt="Deleting Images" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759783/docs/Products/Create%20a%20Product/2.1.1.7_Creating_Products_-_Deleting_Images_spytoy.png" />The alternative text for an image can be modified by clicking on the image, adding the text, and then clicking Save.@@ -59,9 +59,9 @@ The alternative text for an image can be modified by clicking on the image, addiHere you can manage the availability of the product.-IMG+<img alt="Status" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.8_Creating_Products_-_Status_tgzfv5.png" />-### Status+### StatusesThis indicates whether or not the product is available for purchase on the storefront. You can set the status by selecting it from the dropdown. The statuses are as follows:@@ -69,11 +69,11 @@ This indicates whether or not the product is available for purchase on the store* Draft - the product is only visible to the admin-* Archived - …+* Archived### Make Active At-This allows you to set a date on which the product will automatically become Active.+This allows you to set a date on which the product will automatically become Active.Simply set the date and time in the calendar or enter it manually.@@ -95,7 +95,7 @@ Simply set the date and time in the calendar or enter it manually.Product catalog categorization is a vital part of running any ecommerce business, unless you only have a few products. The larger your catalog, the more important it is to thoroughly categorize as it makes product discovery much easier for the end user.-IMG+<img alt="Categorization" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.9_Creating_Products_-_Categorization_b8r5s5.png" />### Taxonomies@@ -105,29 +105,29 @@ By adding the product to a taxon, it will be discoverable wherever that taxon isClicking on the dropdown will display a list of all created taxons to select from or you can narrow the results by typing the name partially or fully.-IMG+<img alt="Taxonomies" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759782/docs/Products/Create%20a%20Product/2.1.1.10_Creating_Products_-_Taxonomies_t4d0gr.png" />In the dropdown, taxons are displayed with reference to their position in the taxonomy to avoid confusion with similarly named taxons, e.g., ‘Fashion -> Women -> Shoes’, ‘Fashion -> Men -> Shoes’.Simply select which taxons you’d like to assign to the product - there’s no limit to the number of the taxons that can be assigned.-IMG+<img alt="Select Taxons" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759783/docs/Products/Create%20a%20Product/2.1.1.11_Creating_Products_-_Select_Taxons_y6xgmc.png" />-To learn how to assign or remove taxons in bulk, please refer to this support article: \{LINK TO BULK OPERATIONS}+To learn how to assign or remove taxons in bulk, please refer to a separate support article.-To learn more about creating taxonomies, please refer to this support article: \{LINK TO TAXONOMIES}+To learn more about creating taxonomies, please refer to a separate support article.### Tags-Product tags are useful for slicing your products into, for example, eco-friendly, vegan, womenswear. Later, you may filter products by tag during merchandising, use it for displaying related products on the storefront, or automatically creating Collections (in the Enterprise Edition).+Product tags are useful for slicing your products into, for example, eco-friendly, vegan, womenswear. Later, you may filter products by tag during merchandising, use it for displaying related products on the storefront, or automatically creating Collections (in the Enterprise Edition).-IMG+<img alt="Tags" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759784/docs/Products/Create%20a%20Product/2.1.1.12_Creating_Products_-_Tags_abs6jj.png" />## Searching Engine ListingHere you can modify the SEO elements of the product. Simply click Edit to open the user interface and modify the fields as necessary.-IMG+<img alt="Search Engine Listing" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759784/docs/Products/Create%20a%20Product/2.1.1.13_Creating_Products_-_Search_Engine_Listing_i00ykf.png" />### Meta Title@@ -145,15 +145,15 @@ Changing this affects the URL of the product page. If not set, the product nameThis is where you add the price to the new product.-IMG+<img alt="Product Price" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759784/docs/Products/Create%20a%20Product/2.1.1.14_Creating_Products_-_Pricing_hrefck.png" />### CurrencyIf your store supports multiple currencies, you’ll be able to set the price for each currency separately.-IMG+<img alt="Product Currency" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759784/docs/Products/Create%20a%20Product/2.1.1.15_Creating_Products_-_Currency_m1np57.png" />-To learn more about multi-currency, please refer to this support article:+To learn more about multi-currency, please refer to this support article:### Amount@@ -163,17 +163,17 @@ Set the price of the product here. This is the amount that will be displayed onIf an item is marked down, you can enter it’s old price in here to show customers how it compares to the new price. This will add a crossed out Compare At Amount and a Sale icon to the product wherever it appears on the storefront.-IMG+<img alt="Compare At Amount" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759787/docs/Products/Create%20a%20Product/2.1.1.16_Creating_Products_-_Compare_At_Amount_hpkzyq.png" />## InventoryThis where you can set the stock quantity and other important inventory settings.-IMG+<img alt="Inventory" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759786/docs/Products/Create%20a%20Product/2.1.1.17_Creating_Products_-_Inventory_oqkby2.png" />If you have multiple stock locations, you’ll be able to set the inventory level for each location separately.-IMG+<img alt="Multiple Stock Locations" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759787/docs/Products/Create%20a%20Product/2.1.1.18_Creating_Products_-_Multiple_Stock_Locations_d4cpqs.png" />### Track Quantity@@ -201,9 +201,9 @@ You might want to use a barcode if you sell products through multiple channels,## Variants-Here is where you can define the different options available for a new product, such as size and color.+Here is where you can define the different options available for a new product, such as size and color.-IMG+<img alt="Variants" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759786/docs/Products/Create%20a%20Product/2.1.1.19_Creating_Products_-_Variants_da8tkf.png" />To add variants to a new products:@@ -217,19 +217,19 @@ To add variants to a new products:5. Repeat steps 1., 2., 3., and 4., if you like to add another Option Type-IMG+<img alt="Add_Options" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759787/docs/Products/Create%20a%20Product/2.1.1.20_Creating_Products_-_Add_Options_lgglby.png" />When clicking Done, you’ll notice the UI changes to combine Pricing and Inventory for each variant, allowing you to set the price and quantity for each separately.-IMG+<img alt="Product UI" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759797/docs/Products/Create%20a%20Product/2.1.1.21_Creating_Products_-_Combined_UI_uugnft.png" />-If you’d like to learn how to add more Option Types, refer to this support article: \{\{LINK TO OPTIONS ARTICLE}}.+If you’d like to learn how to add more Option Types, refer to a separate support article.Pro Tip: Make sure that the Option Values are consistent across all products. For example, don’t set sizes as Small, Medium, Large for one product, and S, M, L for another.## Shipping-IMG+<img alt="Shipping" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733759843/docs/Products/Create%20a%20Product/2.1.1.22_Creating_Products_-_Shipping_y8pttc.png" />### Dimensions & Weight@@ -237,32 +237,32 @@ If you’re planning on using shipping methods that take size and weight of a paYou can select the unit you’d like to use for each field, e.g., Inch or Foot, lbs or oz.-If you’d like to change the system of measurement to metric, you can do so in Settings > Store Details > Standards & Formats. See this article for more information: \{\{LINK TO STORE DETAILS SETTINGS}}+If you’d like to change the system of measurement to metric, you can do so in Settings > Store Details > Standards & Formats. See this a separate support article for more information.### Shipping CategoryHere you can select the shipping category that should be assigned to the product. For example, if it’s a digital product, then it should have the Digital category.-To learn more about shipping categories, please refer to this article: \{\{LINK TO SHIPPING CATEGORIES}}+To learn more about shipping categories, please refer to a separate support article.## PropertiesProduct properties are displayed on the product details page and can convey additional information about the products, such as the material, care instructions, allergens, eco-friendly, etc.-IMG+<img alt="Product Properties" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733760193/docs/Products/Create%20a%20Product/2.1.1.23_Creating_Products_-_Properties_yxn9wq.png" />Simply fill in the fields with the correct values.-To add more Properties, please refer to this support article: \{\{LINK TO PROPERTIES ARTICLE}}+To add more Properties, please refer to a separate support article.## Create ProductNow that you’ve added all the necessary product information, make sure to click the blue Create button at the bottom of the product editor, otherwise you may lose all of your progress.-IMG+<img alt="Create a Product" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733760194/docs/Products/Create%20a%20Product/2.1.1.24_Creating_products_-_Click_Create_vwp1no.png" />## 3rd Party ProductsIf you’re running a marketplace with Spree Enterprise Edition, then you don’t need to worry about creating products because your vendors will be adding them when they onboard.-However, you can still edit some of the product information as outlined in this article: \{\{LINK TO EDITING PRODUCTS}}\ No newline at end of file+However, you can still edit some of the product information as outlined in a separate support article.\ No newline at end of file