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]c74ce3d3c8b7
diff --git a/docs/images/user/products/bulk-product-operations/1.product_tab.png b/docs/images/user/products/bulk-product-operations/1.product_tab.pngnew file mode 100644index 0000000000..db08821582Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/1.product_tab.png differdiff --git a/docs/images/user/products/bulk-product-operations/2.bulk_actions_menu.png b/docs/images/user/products/bulk-product-operations/2.bulk_actions_menu.pngnew file mode 100644index 0000000000..62a0abfb9cBinary files /dev/null and b/docs/images/user/products/bulk-product-operations/2.bulk_actions_menu.png differdiff --git a/docs/images/user/products/bulk-product-operations/3.status.png b/docs/images/user/products/bulk-product-operations/3.status.pngnew file mode 100644index 0000000000..9c2d934ce5Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/3.status.png differdiff --git a/docs/images/user/products/bulk-product-operations/4.add_taxons.png b/docs/images/user/products/bulk-product-operations/4.add_taxons.pngnew file mode 100644index 0000000000..dd0a4a5423Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/4.add_taxons.png differdiff --git a/docs/images/user/products/bulk-product-operations/5.remove_taxons.png b/docs/images/user/products/bulk-product-operations/5.remove_taxons.pngnew file mode 100644index 0000000000..bdbde8c317Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/5.remove_taxons.png differdiff --git a/docs/images/user/products/bulk-product-operations/6.add_tags.png b/docs/images/user/products/bulk-product-operations/6.add_tags.pngnew file mode 100644index 0000000000..9d349d1160Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/6.add_tags.png differdiff --git a/docs/images/user/products/bulk-product-operations/7.remove_tags.png b/docs/images/user/products/bulk-product-operations/7.remove_tags.pngnew file mode 100644index 0000000000..47bbc02748Binary files /dev/null and b/docs/images/user/products/bulk-product-operations/7.remove_tags.png differdiff --git a/docs/images/user/products/bulk-product-operations/8.save_changes.png b/docs/images/user/products/bulk-product-operations/8.save_changes.pngnew file mode 100644index 0000000000..82a10be33fBinary files /dev/null and b/docs/images/user/products/bulk-product-operations/8.save_changes.png differdiff --git a/docs/images/user/products/export-products/1.product_tab.png b/docs/images/user/products/export-products/1.product_tab.pngnew file mode 100644index 0000000000..db08821582Binary files /dev/null and b/docs/images/user/products/export-products/1.product_tab.png differdiff --git a/docs/images/user/products/export-products/2.export_type.png b/docs/images/user/products/export-products/2.export_type.pngnew file mode 100644index 0000000000..536a5870dfBinary files /dev/null and b/docs/images/user/products/export-products/2.export_type.png differdiff --git a/docs/images/user/products/export-products/3.download_link.png b/docs/images/user/products/export-products/3.download_link.pngnew file mode 100644index 0000000000..25a618fd45Binary files /dev/null and b/docs/images/user/products/export-products/3.download_link.png differdiff --git a/docs/images/user/products/searching-products/1.product_tab.png b/docs/images/user/products/searching-products/1.product_tab.pngnew file mode 100644index 0000000000..e9ece5fc6fBinary files /dev/null and b/docs/images/user/products/searching-products/1.product_tab.png differdiff --git a/docs/images/user/products/searching-products/2.search.png b/docs/images/user/products/searching-products/2.search.pngnew file mode 100644index 0000000000..31f0d37766Binary files /dev/null and b/docs/images/user/products/searching-products/2.search.png differdiff --git a/docs/images/user/products/searching-products/3.status_and_stock.png b/docs/images/user/products/searching-products/3.status_and_stock.pngnew file mode 100644index 0000000000..0ed9d36c7eBinary files /dev/null and b/docs/images/user/products/searching-products/3.status_and_stock.png differdiff --git a/docs/images/user/products/searching-products/4.filters.png b/docs/images/user/products/searching-products/4.filters.pngnew file mode 100644index 0000000000..5edffcb26eBinary files /dev/null and b/docs/images/user/products/searching-products/4.filters.png differdiff --git a/docs/images/user/products/searching-products/5.taxon_filter.png b/docs/images/user/products/searching-products/5.taxon_filter.pngnew file mode 100644index 0000000000..dcd9d8f67cBinary files /dev/null and b/docs/images/user/products/searching-products/5.taxon_filter.png differdiff --git a/docs/images/user/products/searching-products/6.tag_filter.png b/docs/images/user/products/searching-products/6.tag_filter.pngnew file mode 100644index 0000000000..f215e97306Binary files /dev/null and b/docs/images/user/products/searching-products/6.tag_filter.png differdiff --git a/docs/images/user/products/searching-products/7.vendor_filter.png b/docs/images/user/products/searching-products/7.vendor_filter.pngnew file mode 100644index 0000000000..faed41aff3Binary files /dev/null and b/docs/images/user/products/searching-products/7.vendor_filter.png differdiff --git a/docs/images/user/products/stock-levels/1.stock_tab.png b/docs/images/user/products/stock-levels/1.stock_tab.pngnew file mode 100644index 0000000000..fd15e655e6Binary files /dev/null and b/docs/images/user/products/stock-levels/1.stock_tab.png differdiff --git a/docs/images/user/products/stock-levels/2.search_filters.png b/docs/images/user/products/stock-levels/2.search_filters.pngnew file mode 100644index 0000000000..39945d5707Binary files /dev/null and b/docs/images/user/products/stock-levels/2.search_filters.png differdiff --git a/docs/images/user/products/stock-levels/3.update_stock_levels.png b/docs/images/user/products/stock-levels/3.update_stock_levels.pngnew file mode 100644index 0000000000..aa59c15342Binary files /dev/null and b/docs/images/user/products/stock-levels/3.update_stock_levels.png differdiff --git a/docs/images/user/products/stock-levels/4.backorderability.png b/docs/images/user/products/stock-levels/4.backorderability.pngnew file mode 100644index 0000000000..22d4c3b1b1Binary files /dev/null and b/docs/images/user/products/stock-levels/4.backorderability.png differdiff --git a/docs/images/user/products/stock-transfers/1.stock_transfers_tab.png b/docs/images/user/products/stock-transfers/1.stock_transfers_tab.pngnew file mode 100644index 0000000000..455ef6e011Binary files /dev/null and b/docs/images/user/products/stock-transfers/1.stock_transfers_tab.png differdiff --git a/docs/images/user/products/stock-transfers/2.transfer_form.png b/docs/images/user/products/stock-transfers/2.transfer_form.pngnew file mode 100644index 0000000000..2c4d2d32f9Binary files /dev/null and b/docs/images/user/products/stock-transfers/2.transfer_form.png differdiff --git a/docs/images/user/products/stock-transfers/3.transfer_details.png b/docs/images/user/products/stock-transfers/3.transfer_details.pngnew file mode 100644index 0000000000..d974b4d709Binary files /dev/null and b/docs/images/user/products/stock-transfers/3.transfer_details.png differdiff --git a/docs/images/user/products/stock-transfers/4.add_products.png b/docs/images/user/products/stock-transfers/4.add_products.pngnew file mode 100644index 0000000000..7870d6835dBinary files /dev/null and b/docs/images/user/products/stock-transfers/4.add_products.png differdiff --git a/docs/images/user/products/stock-transfers/5.select_variants.png b/docs/images/user/products/stock-transfers/5.select_variants.pngnew file mode 100644index 0000000000..bf95dd99a7Binary files /dev/null and b/docs/images/user/products/stock-transfers/5.select_variants.png differdiff --git a/docs/images/user/products/stock-transfers/6.variants_added.png b/docs/images/user/products/stock-transfers/6.variants_added.pngnew file mode 100644index 0000000000..56a5faff87Binary files /dev/null and b/docs/images/user/products/stock-transfers/6.variants_added.png differdiff --git a/docs/images/user/products/stock-transfers/7.transfer_complete.png b/docs/images/user/products/stock-transfers/7.transfer_complete.pngnew file mode 100644index 0000000000..0772c67f40Binary files /dev/null and b/docs/images/user/products/stock-transfers/7.transfer_complete.png differdiff --git a/docs/user/manage-products/bulk-product-operations.mdx b/docs/user/manage-products/bulk-product-operations.mdxindex e5329b819e..cf04959165 100644--- a/docs/user/manage-products/bulk-product-operations.mdx+++ b/docs/user/manage-products/bulk-product-operations.mdx@@ -1,102 +1,86 @@---title: "Bulk Product Operations"-description: "How to do bulk product operations in the Spree admin dashboard"+description: "Learn how to perform bulk product operations in Spree Commerce."----## Bulk Operations+Managing a large product catalog doesn’t mean you need to edit each product one by one. Spree’s bulk operations make it easy to update multiple products at once, saving you time and reducing repetitive work.-When you have a fairly large product catalog, you’ll likely find it much more convenient to manage multiple products at once rather than managing each product separately.+Bulk operations can be used to:-For that reason, there are a number of bulk operations that you can perform to make managing your product catalog less tedious and time consuming.+- Update product statuses+- Add/remove taxons+- Add/remove tags-Bulk operations can be used to do the following:+<Note>+ Bulk operations can be used in combination with product search and filters, for example, to quickly tag all products in a specific taxon.+</Note>-* Update product statuses+## How to Perform Bulk Operations-* Add/remove taxons+Navigate to the **Products** tab in the admin dashboard.-* Add/remove tags+-To perform a bulk operations, navigate to the Products tab of the admin dashboard.+Select one or more products by checking the boxes on the left-hand side of the list.-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733922539/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.1_Bulk_Operations_-_Products_Tab_vvx7fd.png" />+Once selected, the bulk actions menu will appear at the bottom of the page.-To bring up the bulk operations menu, simply select one or more products by checking the boxes on the lefthand side of the list.+-The menu will then pop up at the bottom of the page.+The menu will show how many products are selected and present several action options.-<img alt="Product Bulk Operations Menu" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921795/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.2_Bulk_Operations_-_Bulk_Operations_Menu_paid8z.png" />+## Status Updates-The menu bar has 3 options to choose from, and display the number products selected.+-### Set as Active+The following actions are available directly in the bulk menu:-The first option allows you set all the selected products Active.+- **Set as Active**: Marks selected products as active and visible on the storefront.+- **Set as Draft**: Moves selected products to draft status, making them hidden from the storefront.+- **Set as Archived**: Archives the selected products, removing them from storefront view while keeping them in the admin (accessed in the three-dot menu).-When clicking on the button, a window will open up to confirm the action.+## Taxon Management-<img alt="Set Products As Active" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921791/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.3._Bulk_Operations_-_Set_As_Active_yl5zzi.png" />+These options, accessible in the three-dot menu, let you bulk-manage product categories and collections:-### Set as Draft+### Add to Taxons-The second option allows you set all of the selected products to Draft.+-As above, clicking on the button, a window will open up to confirm the action.+Using the **Add to taxons** operation, you can assign one or more taxons to the selected products.-<img alt="Set Products As Draft" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921791/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.4_Bulk_Operations_-_Set_As_Draft_wknizb.png" />+Simply select taxons from the dropdown list or start typing to narrow results.-### Other Operations (...)+### Remove from Taxons-Clicking on the three dots opens a submenu that contains other useful bulk operations.+-<img alt="Other Product Operations" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921793/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.5_Bulk_Operations_-_Other_Operations_sihz3j.png" />+Similar to above, you can use the **Remove from taxons** operation to remove specific taxons from selected products.-Let’s take a look at each operation individually.+Multiple taxons can be removed at once using the same interface.-### Set as Archived+## Tag Management-Allows you to set the selected products as Archived.+You can also quickly assign or unassign tags across multiple products:-#### Add to Taxons+### Add Tags-Allows you to assign taxons to the selected products.+-When clicking on ‘Add to taxons’, a window will appear that allows you to select the taxons you’d like to assign to the products. You can assign multiple taxons at the same time.+Using the **Add tags** operation, you can apply one or more tags to all selected products at once.-Either scroll through and select them from the list or start typing the name to narrow the results.+Select tags from the dropdown list or create new ones on the fly directly within the interface.-<img alt="Add Products to Taxons" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921793/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.6_Bulk_Operations_-_Add_To_Taxons_kirhtx.png" />+### Remove Tags-#### Remove From Taxons+-Allows you to remove taxons from the selected products.+The **Remove tags** operation allows you to remove selected tags from all chosen products.-When clicking on ‘Remove from taxons’, a window will appear that allows you to select the taxons you’d like to remove from the products. You can remove multiple taxons at the same time.+As before, multiple tags can be removed at once.-Either scroll through and select them from the list or start typing the name to narrow the results.+## Saving Changes-<img alt="Remove Products From Taxons" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921792/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.7_Bulk_Operations_-_Remove_From_Taxons_rgd9m6.png" />+-#### Add Tags--Allows you to assign tags to the selected products.--When clicking on ‘Add tags’, a window will appear that allows you to select the taxons you’d like to assign to the products. You can assign multiple tags at the same time.--Either scroll through and select them from the list or start typing the name to narrow the results.--<img alt="Add Tags to Products" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921792/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.8_Bulk_Operations_-_Add_Tags_wiejxn.png" />--#### Remove Tags--Allows you to remove tags from the selected products.--When clicking on ‘Remove tags’’, a window will appear that allows you to select the tags you’d like to remove from the products. You can remove multiple tags at the same time.--Either scroll through and select them from the list or start typing the name to narrow the results.--<img alt="Remove Tags from Products" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921794/docs/Manage%20Products/Bulk%20Product%20Operations/2.2.2.9_Bulk_Operations_-_Remove_Tags_wirwbq.png" />--### Cick Save--Whichever operation you’d like to perform, always make sure to click the blue Save button to save changes.\ No newline at end of file+After selecting and confirming your desired operation, always click **Save** in the bottom right corner of the modal to apply your changes.\ No newline at end of filediff --git a/docs/user/manage-products/export-products.mdx b/docs/user/manage-products/export-products.mdxindex aabed40141..2b05241e94 100644--- a/docs/user/manage-products/export-products.mdx+++ b/docs/user/manage-products/export-products.mdx@@ -1,30 +1,29 @@---title: "Export Products"-description: "How to export products in the Spree open-source eCommerce dashboard"+description: "Learn how to export your product catalog in Spree Commerce."----Exporting your product catalog can be useful for several reasons. For example, you may wish to upload your products to another system or you might want to update product data in bulk.+Exporting your product catalog can be useful for a variety of tasks, such as reviewing product data in bulk, backing up product information, or syncing catalog details with external systems like ERPs or reporting tools.-To export your product catalog, navigate to the Products tab of the admin dashboard.+## How to Export Your Product Catalog-<img alt="Product Export" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430408/docs/Manage%20Products/Export%20Products/2.2.4.1_Product_Export_-_Products_Tab_ftzk9d.png" />+To export your product catalog, navigate to the **Products** tab of the admin dashboard.-Locate the ‘Export button in the top right corner.+-Clicking on this will allow you to choose one of two options:+Click on **Export** in the top right corner.-1. Filtered Records - Export only filtered records, matching the search criteria+-2. All - Export all records (can be slow for large datasets)+This opens a export modal that gives you two options to choose from:-<img alt="Export Products into a CSV" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430408/docs/Manage%20Products/Export%20Products/2.2.4.2_Product_Export_-_Click_Export_znjjlp.png" />+- **Filtered Records**: Export only filtered records matching the search criteria+- **All**: Export all records (can be slow for large datasets)-If you plan to export a subset of your product catalog, make sure to apply desired filters before clicking Export.+<Warning>+ If you plan to export a subset of your product catalog, make sure to apply the appropriate filters before clicking **Export**.+</Warning>-Once you’re happy with your selection, click the blue Export button, and a link to download the file will be sent to the email address associated with your user account.+Once you’ve made your selection, click **Export** in the modal, and a link to download the file will be sent to the email address associated with your user account.-<img alt="Product Export into CSV Complete" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430408/docs/Manage%20Products/Export%20Products/2.2.4.3_Product_Export_-_Export_Complete_kpl7f5.png" />--## Update Products in Bulk--If you’re planning to update product data in bulk, simply open the exported file in your preferred spreadsheet software, edit all of product fields you’d like to change, and then reupload the file to update the product data in Spree.\ No newline at end of file+\ No newline at end of filediff --git a/docs/user/manage-products/product-options.mdx b/docs/user/manage-products/product-options.mdxindex 35295f982f..d167d10069 100644--- a/docs/user/manage-products/product-options.mdx+++ b/docs/user/manage-products/product-options.mdx@@ -11,17 +11,25 @@ Additionally, they can streamline inventory management by linking variations toTo manage Options, navigate to the Options tab of the admin dashboard, found under Products.-<img alt="Product Options Dashboard Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.1_Options_-_Navigate_To_Tab_ckkk2a.png" />+<img+ alt="Product Options Dashboard Tab"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.1_Options_-_Navigate_To_Tab_ckkk2a.png"+/>Here you’ll see a list of all the Options currently available on your store.## Add an New Option-To add a new Option, click ‘+ New Option Type’ in the top right corner.+To add a new Option, click ‘\+ New Option Type’ in the top right corner.This will redirect you to the Option creation page.-<img alt="Add New Product Option" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624483/docs/Manage%20Products/Product%20Options/2.5.2_Options_-_Add_New_Option_kvvsib.png" />+<img+ alt="Add New Product Option"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624483/docs/Manage%20Products/Product%20Options/2.5.2_Options_-_Add_New_Option_kvvsib.png"+/>### General Information@@ -29,67 +37,119 @@ In this section you can set the name of the Option as should be displayed on theIf you don’t set an internal name, the presentation name will be used.-<img alt="Presentation Name And Internal Name" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.3_Options_-_Presentation_Name_And_Internal_Name_zkbgcj.png" />+<img+ alt="Presentation Name And Internal Name"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.3_Options_-_Presentation_Name_And_Internal_Name_zkbgcj.png"+/>### FilterableIn the General Information section, you can also select whether or not you want this Option to be filterable on product listing pages.-<img alt="Filterable" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.4_Options_-_Filterable_cdgyhc.png" />+<img+ alt="Filterable"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.4_Options_-_Filterable_cdgyhc.png"+/>When an option type is set to Filterable, your storefront visitors are presented with the option to filter a taxon of products based on the option type. A typical example of this would be to filter clothing by size and color as shown here:-<img alt="Storefront Filters" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.5_Options_-_Storefront_Filters_xamhgf.png" />+<img+ alt="Storefront Filters"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.5_Options_-_Storefront_Filters_xamhgf.png"+/>### Option ValuesOption Types represent the attribute being customized, such as size, color, or material, while Option Values are the specific choices available for that attribute, like Small, Red, or Cotton.-<img alt="Product Option Values" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.6_Options_-_Option_Values_skkhlu.png" />+<img+ alt="Product Option Values"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.6_Options_-_Option_Values_skkhlu.png"+/>-Simply enter the names of the values, and click ‘+ Add One’ to add more values.+Simply enter the names of the values, and click ‘\+ Add One’ to add more values.-<img alt="Enter Values" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.7_Options_-_Enter_Values_txckof.png" />+<img+ alt="Enter Values"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624482/docs/Manage%20Products/Product%20Options/2.5.7_Options_-_Enter_Values_txckof.png"+/>Note: When creating or importing products, any new Option Values that haven’t already been added to this Option will be added automatically.Once you’re finished adding values, click the blue ‘Create’ button at the bottom of the page, and you’ll receive a notification that the Option has been successfully created.-<img alt="Option Created" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.8_Options_-_Option_Created_o38zio.png" />+<img+ alt="Option Created"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.8_Options_-_Option_Created_o38zio.png"+/>## Option ManagementNavigating back to the Options page, you’ll see that your newly created option is now listed among your other Options.-<img alt="Product Options_Management" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.9_Options_-_Options_Management_sgru96.png" />+<img+ alt="Product Options_Management"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.9_Options_-_Options_Management_sgru96.png"+/>### Option OrderingIf you’d like to change the order in which Options are displayed on the storefront, e.g., in filters and on product detail pages, you can drag and drop them into position by clicking on the 6 dots on the left hand side.-<img alt="Product Option Ordering" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.10_Options_-_Option_Ordering_z0w0uh.png" />+<img+ alt="Product Option Ordering"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624484/docs/Manage%20Products/Product%20Options/2.5.10_Options_-_Option_Ordering_z0w0uh.png"+/>For example, this will change the filter from this:-<img alt="Original Order" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734627725/docs/Manage%20Products/Product%20Options/2.5.11_Options_-_Original_Order_sjy2f9.png" />+<img+ alt="Original Order"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734627725/docs/Manage%20Products/Product%20Options/2.5.11_Options_-_Original_Order_sjy2f9.png"+/>To this:-<img alt="New Order" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734627725/docs/Manage%20Products/Product%20Options/2.5.12_Options_-_New_Order_xutfw0.png" />+<img+ alt="New Order"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734627725/docs/Manage%20Products/Product%20Options/2.5.12_Options_-_New_Order_xutfw0.png"+/>The effect is similar on product detail pages:-<img alt="PDP Order" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624486/docs/Manage%20Products/Product%20Options/2.5.13_Options_-_PDP_Order_vnkzk1.png" />+<img+ alt="PDP Order"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624486/docs/Manage%20Products/Product%20Options/2.5.13_Options_-_PDP_Order_vnkzk1.png"+/>### Edit OptionsTo edit an Option, navigate to the Options tab, and click ‘Edit’ on the option you’d like to edit.-<img alt="Edit Options" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.14_Options_-_Edit_Options_h8urqo.png" />+<img+ alt="Edit Options"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.14_Options_-_Edit_Options_h8urqo.png"+/>Feel free to change the Presentation Name, Internal Name, check or uncheck the Filterable box, and add or remove Option Values.-<img alt="Make Changes and Update" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.15_Options_-_Makes_Changes_and_Update_bm2sgn.png" />+<img+ alt="Make Changes and Update"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.15_Options_-_Makes_Changes_and_Update_bm2sgn.png"+/>Once you’re finished, make sure to click the blue ‘Update’ button at the bottom of the page.@@ -97,11 +157,19 @@ Once you’re finished, make sure to click the blue ‘Update’ button at the bTo delete an Option, navigate to the Options tab, and click ‘Edit’ on the option you’d like to delete.-<img alt="Delete An Option" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.16_Options_-_Delete_An_Option_ejatzm.png" />+<img+ alt="Delete An Option"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.16_Options_-_Delete_An_Option_ejatzm.png"+/>On the Option editor page, locate the red ‘Delete button at the bottom of the page and the Option will be deleted.-<img alt="Click Delete" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.17_Options_-_Click_Delete_dy877y.png" />+<img+ alt="Click Delete"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734624485/docs/Manage%20Products/Product%20Options/2.5.17_Options_-_Click_Delete_dy877y.png"+/>## Import Options@@ -116,13 +184,8 @@ These powerful features work together to make products more discoverable, appealLet’s dive deep into how these tools can revolutionize your product presentation and drive better business outcomes:1. [Understanding Product Properties: The DNA of Your Products](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Product-Properties)-2. [Understanding Product Options: The Power of Choice](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Product-Options)-3. [Product Properties vs. Product Options: Understanding the Distinction](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Properties-vs-Options)-4. [Leveraging Properties and Options for Better Business Outcomes](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Leveraging-Properties-and-Options)-5. [Bringing It All Together in Spree 5](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Spree-5)-6. [Next Steps](https://spreecommerce.org/product-properties-and-product-options-a-strategic-guide-to-improving-conversions-and-seo/#Next-Steps)\ No newline at end of filediff --git a/docs/user/manage-products/product-taxonomies.mdx b/docs/user/manage-products/product-taxonomies.mdxindex fef376f78e..cadc961707 100644--- a/docs/user/manage-products/product-taxonomies.mdx+++ b/docs/user/manage-products/product-taxonomies.mdx@@ -11,15 +11,17 @@ A well-designed taxonomy enhances search functionality, improves user experienceTo setup taxonomies for your store, navigate to the Taxomonies tab of the admin dashboard, found under Products.-<img alt="Product Categories Collections Taxonomies" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530069/docs/Manage%20Products/Product%20Taxonomies/2.4.1_Taxonomies_-_Navigate_To_Tab_tbik8x.png" />+<img+ alt="Product Categories Collections Taxonomies"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530069/docs/Manage%20Products/Product%20Taxonomies/2.4.1_Taxonomies_-_Navigate_To_Tab_tbik8x.png"+/>Here you will see three automatically created taxonomies that are commonly used in ecommerce:-* Categories - Groups of products based on type or purpose for easy navigation--* Brands - Organizes products by their manufacturer or label--* Collections - Curated groups of products based on themes or trends+- Categories - Groups of products based on type or purpose for easy navigation+- Brands - Organizes products by their manufacturer or label+- Collections - Curated groups of products based on themes or trends## Add a New Taxonomy@@ -27,21 +29,33 @@ To add a new Taxonomy, such as a Category, Collection, or Brand, click on the blThis will redirect you to the Taxonomy creation page where you simply need to type in a name.-<img alt="Add A New Taxonomy: Category, Collection, Brand" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530072/docs/Manage%20Products/Product%20Taxonomies/2.4.2_Taxonomies_-_Add_A_New_Taxonomy_zlsju3.png" />+<img+ alt="Add A New Taxonomy: Category, Collection, Brand"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530072/docs/Manage%20Products/Product%20Taxonomies/2.4.2_Taxonomies_-_Add_A_New_Taxonomy_zlsju3.png"+/>Enter the name, and click the blue ‘Create’ button and youll receive a notification that the taxonomy has been successfully created.You’ll then be redirected to a page that allows you to manage the new taxonomy.-<img alt="Create Taxonomy" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530075/docs/Manage%20Products/Product%20Taxonomies/2.4.3_Taxonomies_-_Create_Taxonomy_jldjm8.png" />+<img+ alt="Create Taxonomy"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530075/docs/Manage%20Products/Product%20Taxonomies/2.4.3_Taxonomies_-_Create_Taxonomy_jldjm8.png"+/>## Add TaxonsWith the taxonomy created, you can start adding taxons to organize your product catalog more effectively.-To add a taxon, either click the blue ‘+ New Taxon’ button in the top right corner or (in the case of an empty taxonomy), click ‘+ Add One’ in the middle of the page.+To add a taxon, either click the blue ‘\+ New Taxon’ button in the top right corner or (in the case of an empty taxonomy), click ‘\+ Add One’ in the middle of the page.-<img alt="Add Taxons" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.4_Taxonomies_-_Add_Taxons_hestoh.png" />+<img+ alt="Add Taxons"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.4_Taxonomies_-_Add_Taxons_hestoh.png"+/>This opens up the taxon editor page which allows you to define the taxon and add media.@@ -49,19 +63,20 @@ This opens up the taxon editor page which allows you to define the taxon and addThere are four sections that affect how the taxon is presented on the storefront:-* Name - Add a name to be displayed on the frontend and backend--* Description - Add text describing the taxon, optionally displayed on the storefront--* Image - Upload a complimentary image to be displayed on the taxons storefront page--* Square Image - Upload a complimentary square image to optionally be displayed in page sections featuring that taxon+- Name - Add a name to be displayed on the frontend and backend+- Description - Add text describing the taxon, optionally displayed on the storefront+- Image - Upload a complimentary image to be displayed on the taxons storefront page+- Square Image - Upload a complimentary square image to optionally be displayed in page sections featuring that taxon### Taxon TypeTaxon Type allows you to choose between a manual taxon or an automatic taxon.-<img alt="Taxon Type" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.5_Taxonomies_-_Taxon_Type_rqqr3h.png" />+<img+ alt="Taxon Type"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.5_Taxonomies_-_Taxon_Type_rqqr3h.png"+/>#### Manual Taxons@@ -71,67 +86,99 @@ As the name suggests, you must add products manually, either by assigning producAllows you to automatically (and dynamically) populate the taxon based on various conditions.-<img alt="Automatic Taxons: Categories or Collections" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530070/docs/Manage%20Products/Product%20Taxonomies/2.4.6_Taxonomies_-_Automatic_Taxons_ueavhp.png" />+<img+ alt="Automatic Taxons: Categories or Collections"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530070/docs/Manage%20Products/Product%20Taxonomies/2.4.6_Taxonomies_-_Automatic_Taxons_ueavhp.png"+/>You can choose whether the products must match all conditions or any of the conditions you define.The condition types are as follows:-* Product tag - products will only be included if they have a mathing tag--* Available on - products will only be included if they were made available within the specified time frame--* Sale - products will only be included if they are marked down (i.e., a Compare At Amount is set)--* Product vendor - products will only be included if they are from a particular vendor+- Product tag - products will only be included if they have a mathing tag+- Available on - products will only be included if they were made available within the specified time frame+- Sale - products will only be included if they are marked down (i.e., a Compare At Amount is set)+- Product vendor - products will only be included if they are from a particular vendorOnce you’ve selected the condition type, you can select the value from the dropdown that the condition should be equal to, not equal to, contain, or not contain-<img alt="Condition Values" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530072/docs/Manage%20Products/Product%20Taxonomies/2.4.7_Taxonomies_-_Condition_Values_ocu8qi.png" />+<img+ alt="Condition Values"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530072/docs/Manage%20Products/Product%20Taxonomies/2.4.7_Taxonomies_-_Condition_Values_ocu8qi.png"+/>-Feel free to add more conditions to further curate the taxon by clicking onn ‘+ Add One’.+Feel free to add more conditions to further curate the taxon by clicking onn ‘\+ Add One’.### NavigationHere you can select where the new taxon should be nested.-<img alt="Navigation" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.8_Taxonomies_-_Navigation_eb8tjq.png" />+<img+ alt="Navigation"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.8_Taxonomies_-_Navigation_eb8tjq.png"+/>The dropdown list will show a list of all taxons available within the taxonomy your currently managing. Simply select the taxon you’d like to nest the new taxon in.Start typing the name of the taxon you’d like to nest within to filter the results.-<img alt="Navigation Filtering" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530070/docs/Manage%20Products/Product%20Taxonomies/2.4.9_Taxonomies_-_Navigation_Filtering_xznfix.png" />+<img+ alt="Navigation Filtering"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530070/docs/Manage%20Products/Product%20Taxonomies/2.4.9_Taxonomies_-_Navigation_Filtering_xznfix.png"+/>### Search Engine ListingHere you can set the meta title, meta description, and the slug for the new taxon.-<img alt="Search Engine Listing" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530069/docs/Manage%20Products/Product%20Taxonomies/2.4.10_Taxonomies_-_Search_Engine_Listing_kouuok.png" />+<img+ alt="Search Engine Listing"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530069/docs/Manage%20Products/Product%20Taxonomies/2.4.10_Taxonomies_-_Search_Engine_Listing_kouuok.png"+/>### Create TaxonOnce you’ve added the name and defined the taxon type, click the blue ‘Create’ button at the bottom of the page to create the taxon, and you’ll receive a notification that the taxon was successfully created.-<img classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.11_Taxonomies_-_Taxon_Created_nlmenj.png" />+<img+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.11_Taxonomies_-_Taxon_Created_nlmenj.png"+/>### Add Products-Once the taxon is created, you can add products to the taxon directly in taxon editor page by clicking ‘+ Add Products’, if and only if you chose the manual Taxon Type.+Once the taxon is created, you can add products to the taxon directly in taxon editor page by clicking ‘\+ Add Products’, if and only if you chose the manual Taxon Type.-<img alt="Add Products to Taxonomies: Categories or Collections" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.12_Taxonomies_-_Add_Products_kzpb0v.png" />+<img+ alt="Add Products to Taxonomies: Categories or Collections"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530068/docs/Manage%20Products/Product%20Taxonomies/2.4.12_Taxonomies_-_Add_Products_kzpb0v.png"+/>This will open a window that allows you to search for and select the products you’d like to add.Check the boxes of the products you’d like to and then click the blue button.-<img alt="Select Products" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530079/docs/Manage%20Products/Product%20Taxonomies/2.4.13_Taxonomies_-_Select_Products_rhaqzp.png" />+<img+ alt="Select Products"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530079/docs/Manage%20Products/Product%20Taxonomies/2.4.13_Taxonomies_-_Select_Products_rhaqzp.png"+/>You’ll then see those products listed in the Products section of the taxon editor.Note: You can removed individual products by clicking on the red trash can button in the far right column.-<img alt="Products Added" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530074/docs/Manage%20Products/Product%20Taxonomies/2.4.14_Taxonomies_-_Products_Added_neudzx.png" />+<img+ alt="Products Added"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530074/docs/Manage%20Products/Product%20Taxonomies/2.4.14_Taxonomies_-_Products_Added_neudzx.png"+/>### Sort Order@@ -139,11 +186,19 @@ For merchandising purposes, you may want to change the order in which products iTo do so, you can select the sort order from the dropdown menu in the Products section of the taxon editor.-<img alt="Sort Order" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530073/docs/Manage%20Products/Product%20Taxonomies/2.4.15_Taxonomies_-_Sort_Order_cm4ivj.png" />+<img+ alt="Sort Order"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530073/docs/Manage%20Products/Product%20Taxonomies/2.4.15_Taxonomies_-_Sort_Order_cm4ivj.png"+/>If you choose manual sort order, you can rearrange the ordering by clicking on the 6 dots on the far left and drag and dropping the products into the desired order.-<img alt="Taxonomies Manual Ordering" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530073/docs/Manage%20Products/Product%20Taxonomies/2.4.16_Taxonomies_-_Manual_Ordering_kahfht.png" />+<img+ alt="Taxonomies Manual Ordering"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530073/docs/Manage%20Products/Product%20Taxonomies/2.4.16_Taxonomies_-_Manual_Ordering_kahfht.png"+/>Important: Make sure to hit ‘Update’ at the bottom of the page if you want to save any changes you’ve made to taxon.@@ -151,31 +206,40 @@ Important: Make sure to hit ‘Update’ at the bottom of the page if you want tIf you’d like to create multiple levels of the taxonomy tree, you can add add subtaxons (i.e. nested taxons) to an existing taxon.-Simply click on the 3 dots on the far left of the taxon and select ‘+ New Nested Taxon’.+Simply click on the 3 dots on the far left of the taxon and select ‘\+ New Nested Taxon’.-<img alt="Nested Taxons: Collections or Categories" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530071/docs/Manage%20Products/Product%20Taxonomies/2.4.17_Taxonomies_-_Nested_Taxons_cxv5mr.png" />+<img+ alt="Nested Taxons: Collections or Categories"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530071/docs/Manage%20Products/Product%20Taxonomies/2.4.17_Taxonomies_-_Nested_Taxons_cxv5mr.png"+/>The rest of the process is the same as adding any other taxon.With some careful consideration, time and little effort, you can create a very deep and detailed taxonomy tree.-<img alt="Taxonomy Tree: Category Tree, Collection Tree" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530074/docs/Manage%20Products/Product%20Taxonomies/2.4.18_Taxonomies_-_Taxonomy_Tree_sq5vgk.png" />+<img+ alt="Taxonomy Tree: Category Tree, Collection Tree"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530074/docs/Manage%20Products/Product%20Taxonomies/2.4.18_Taxonomies_-_Taxonomy_Tree_sq5vgk.png"+/>If you’d like to reorganize your taxonomy later, you can do so by drag and dropping taxons into their new positions.-<img alt="Reordering Taxons: Catgories or Collections or Brands" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530076/docs/Manage%20Products/Product%20Taxonomies/2.4.19_Taxonomies_-_Reordering_Taxons_ljppr7.png" />+<img+ alt="Reordering Taxons: Catgories or Collections or Brands"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530076/docs/Manage%20Products/Product%20Taxonomies/2.4.19_Taxonomies_-_Reordering_Taxons_ljppr7.png"+/>## Import TaxonsTaxons can be automatically imported if you add the appropriate values to the category columns in a product import file. Just make sure to use the correct naming convention for the taxons to make sure nesting is respected after import, e.g.:-* Categories -> Fashion -> Men--* Categories -> Fashion -> Women -> Footwear--* Categories -> Electronics -> TVs--* Categories -> Nutrition -> Supplements -> Vitamins+- Categories -\> Fashion -\> Men+- Categories -\> Fashion -\> Women -\> Footwear+- Categories -\> Electronics -\> TVs+- Categories -\> Nutrition -\> Supplements -\> VitaminsTo learn more about imports, please refer to the [Import Products](https://spreecommerce.org/docs/user/manage-products/import-products) article.@@ -183,11 +247,18 @@ To learn more about imports, please refer to the [Import Products](https://spreeIf you’d like to change the name of a taxonomy, navigate back to the main Taxonomies tab.-<img alt="Edit Taxonomies: Categories or Collections or Brands" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.20_Taxonomies_-_Edit_Taxonomies_awmeg0.png" />+<img+ alt="Edit Taxonomies: Categories or Collections or Brands"+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.20_Taxonomies_-_Edit_Taxonomies_awmeg0.png"+/>Find the taxonomy you’d like to rename, and click the Edit button the far right side.-<img classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.21_Taxonomies_-_Rename_Taxonomy_chetzs.png" />+<img+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530078/docs/Manage%20Products/Product%20Taxonomies/2.4.21_Taxonomies_-_Rename_Taxonomy_chetzs.png"+/>Simply rename the taxonomy and click ‘Update’.@@ -195,7 +266,10 @@ Simply rename the taxonomy and click ‘Update’.To edit a taxon, find the taxon you’d like to edit in its respective taxonomy, and click the Edit button on the far right.-<img classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530080/docs/Manage%20Products/Product%20Taxonomies/2.4.22_Taxonomies_-_Edit_Taxons_dkly9r.png" />+<img+ classname="block dark:hidden"+ src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734530080/docs/Manage%20Products/Product%20Taxonomies/2.4.22_Taxonomies_-_Edit_Taxons_dkly9r.png"+/>You’re free to edit the name and description, swap out images, change the nesting, and update search engine listing settings. Make sure to click Update if you do.@@ -207,14 +281,10 @@ If you’re store is multi-language, you can add translations for both taxonomieTo learn more about translations, please refer to another support article.-## Real-Life Examples ofCategories, Collections, and Brands+## Real-Life Examples of Categories, Collections, and Brands1. [Industry-Specific Taxonomy Needs](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Industry-Specific)-2. [Multiple Category Trees](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Multiple-Category-Trees)-3. [Collection Merchandising](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Collection-Merchandising)-4. [Taxonomy Visibility & Product Discovery](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Taxonomy-Visibility-Product-Discovery)-5. [Taxonomy Tools](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Taxonomy-Tools)\ No newline at end of filediff --git a/docs/user/manage-products/search-products.mdx b/docs/user/manage-products/search-products.mdxindex 123f3f8550..a585debf02 100644--- a/docs/user/manage-products/search-products.mdx+++ b/docs/user/manage-products/search-products.mdx@@ -1,72 +1,67 @@----title: "Search Products"-description: "How to Search Products in the Spree open-source eCommerce dashboard"+title: "Searching Products"+description: "Learn how to search for products in the Spree Commerce dashboard."----## Searching Products+As your catalog grows, manually scrolling through the Products list becomes less practical. Fortunately, Spree’s search and filtering tools make it easy to find exactly what you’re looking for - whether it's a specific product, a group by status, or everything under a certain category.-The more products you add to your store, the more challenging it becomes to manage your product catalog.+## How to Search & Filter Products-Using search and filters can make it much more convenient to find the products you’d like to manage, as opposed to scrolling through thousands of products in the hopes of finding the one you’re looking.+To begin, go to the **Products** tab in the admin dashboard.-To use product search and filters, navigate to the Products tab of the admin dashboard.+-<img alt="Products Management Tab" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921781/docs/Manage%20Products/Search%20Products/2.2.1.1_Searching_Products_-_Products_Tab_i91fov.png" />--At the top, you’ll notice the Search bar and some filtering options. Let’s take a look at each separately.+At the top of the page, you’ll find a search bar and a variety of filtering options to help narrow down results.### Search-The search bar allows you to enter a query and return a list of products that match that the query.--<img alt="Product Search" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921778/docs/Manage%20Products/Search%20Products/2.2.1.2_Searching_Products_-_Search_r6cnhz.png" />--To remove the query, simply click the X next to the query that’s displayed below the search bar.--### Status and Stock Filter+-The box that (by default) contains “Show:All products” is a dropdown that allows you to narrow product results by their status and whether or not they are in stock.+Use the search bar to quickly find products by name or keyword.-Simply click on the dropdown and select the option you’d like to filter.+Results update automatically to match your query.-<img alt="Status and Stock" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921780/docs/Manage%20Products/Search%20Products/2.2.1.3_Searching_Products_-_Status_and_Stock_r2dfqg.png" />+To clear the current search, click the **X** next to the query label below the search bar.-You can have one filter active from each of Status and Stock at a time, and the current selection will be displayed in the box, e.g., ‘Active and In Stock’+### Status & Stock Filters-<img alt="Product Active Selection" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921779/docs/Manage%20Products/Search%20Products/2.2.1.4_Searching_Products_-_Active_Selection_apgzj7.png" />+-### Filters+The dropdown labeled **Show: All Products** allows you to filter by:-Filters allow you to the refine your search based on other criteria, such as taxons, vendors, and tags.+- **Status**: Active, Draft, or Archived+- **Stock availability**: Any stock, In Stock, or Out of Stock-<img alt="Product Filters" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921777/docs/Manage%20Products/Search%20Products/2.2.1.5_Searching_Products_-_Filters_f2jfhz.png" />+You can apply one filter from each category at a time (e.g., Active and In Stock). The current filter selection will be reflected in the label.-#### Taxons+## Additional Filters-Here you can filter products based on the categories, brands, collections, etc., the products belong to.+-Simply select the taxons you’d like to filter by from the dropdown.+Click the **Filters** button to open more filtering options. These include:-<img alt="Product Taxon Filter" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921778/docs/Manage%20Products/Search%20Products/2.2.1.6_Searching_Products_-_Taxon_Filter_ogeq6l.png" />+### Taxons-To learn more about taxons, please refer to another support article.+-#### Tags+Here, you can filter by category, collection, brand, or any other taxonomy you’ve defined (e.g., Categories → Men → Shoes or Collections → Spring).-Here you can filter products based on the tags that have been assigned to them.+Feel free to select multiple taxons from the dropdown, or select **Without taxon** to filter by products that haven’t been merchandised yet.-Simply select the tags you’d like to filter by from the dropdown.+To learn more about organizing products into taxons, see **Taxonomies**.-<img alt="Product Tag Filter" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921778/docs/Manage%20Products/Search%20Products/2.2.1.6_Searching_Products_-_Tag_Filter_ffuaho.png" />+### Tags-To learn more about tags, please refer to another support article.+-#### Vendors (Enterprise Edition only)+You can also filter products by one or more tags which can be helpful for merchandising or marketing workflows (e.g., Sale, New Arrival, Vegan).-If you’re running a multi-vendor platform with Spree Enterprise Edition, you can also filter products based on the vendor that uploaded them.+<Note>+ Tags can be added in the product editor or via bulk actions.+</Note>-Simply select the vendors you’d like to filter by from the dropdown+### Vendors (Enterprise only)-<img alt="Produt Vendor Filter" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1733921778/docs/Manage%20Products/Search%20Products/2.2.1.7_Searching_Products_-_Vendor_Filter_ngtf7o.png" />+-To learn more about onboarding vendors, please refer to another support article.\ No newline at end of file+If you're using Spree Enterprise, you can also filter products by vendor which is incredibly useful for managing multi-vendor catalogs.\ No newline at end of filediff --git a/docs/user/manage-products/stock-levels.mdx b/docs/user/manage-products/stock-levels.mdxindex d5069ccd3d..a06ad2874f 100644--- a/docs/user/manage-products/stock-levels.mdx+++ b/docs/user/manage-products/stock-levels.mdx@@ -1,40 +1,53 @@---title: "Stock Levels"-description: "How to manage stock levels in the Spree open-source eCommerce dashboard"+description: "Learn how to manage stock levels in Spree Commerce."----Maintaining accurate stock levels is crucial in e-commerce for several reasons such as customer satisfaction, operational efficiency, and financial management, to name a few.+Maintaining accurate stock levels is critical for delivering a smooth customer experience, avoiding overselling, and ensuring clean operational and financial reporting.-There are several ways to manage stock levels in Spree:+There are two main ways to manage inventory, depending on your workflow:-* Update stock levels of individual products using the product editor+- Edit stock levels individually via the product editor+- Manage inventory directly from the **Stock Items** tab (covered in this article)-* Update stock levels in bulk using a CSV upload+<Note>When a customer places an order, stock quantities are automatically reduced based on the quantity purchased. Similarly, when items are returned and marked as resellable, the stock quantities will automatically increase.</Note>-* Update stock levels using the Stock Items tab+## How to Manage Stock Levels-<Note>This support article covers the use of the Stock Items tab to update stock levels.</Note>+To manage stock levels across your catalog, navigate to **Products → Stock → Stock Items.**-When a product is purchased by a customer, the quantity of the product sold is automatically deducted from the total quantity.+-To get started, navigate to the Stock Items tab found under Products > Stock in the admin dashboard, where you’ll be greeted by a list of products.+Here you’ll see a list of all product variants, separated by stock location (i.e., if you have two stock locations, each variant will have two rows in the table).-<img alt="Stock Levels" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430753/docs/Manage%20Products/Stock%20Levels/2.3.1.1_Stock_Items_-_Navigate_To_Tab_ew6unz.png" />+You can use the search bar to filter by product name, SKU (partial or full), or stock location.-This list shows the quantity of each product variant available at each of your stock locations.+-You can filter the list by searching the product name, SKU (partial or full), and/or the stock location.+This makes it easier to manage stock updates when, for example, receiving a new shipment to a specific warehouse or restocking a particular product line.-<img alt="Product Filters" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430752/docs/Manage%20Products/Stock%20Levels/2.3.1.2_Stock_Items_-_Filters_iwmanv.png" />+## Updating Stock Levels-Once you’ve found the variant(s) for which you’d like to update the quantity, you simply need to type in the new quantity in ‘Count On Hand’ column, and click the corresponding Update button.+-A green popup will appear at the top of the screen to ntofiy you that the Stock Item has been successfully updated.+To adjust stock levels:-<img alt="Update Stock Level Quantities" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430754/docs/Manage%20Products/Stock%20Levels/2.3.1.3_Stock_Items_-_Update_Quantities_aqyqf3.png" />+1. Locate the variant you want to update+2. Enter the new quantity in the **Count On Hand** column+3. Click **Update** at the end of the row-You can also set whether or not to make any of your product backorderable but simply checking the box in the ‘Backorderable’ column (no need to click update - this change will automatically be saved).+You’ll see a green confirmation popup at the top of the screen once the update is saved.-<img alt="Backorderable Products" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734430754/docs/Manage%20Products/Stock%20Levels/2.3.1.4_Stock_Items_-_Backorderable_jztlp8.png" />+<Note>Each variant/location combination must be updated independently.</Note>-<Warning>Marking products as backorderable will allow them to be sold even when out of stock, so make sure not to mark products as backorderable if you don’t intend to restock them.</Warning>\ No newline at end of file+## Enabling Backorders++++You can allow a product to be sold even when its inventory reaches zero by marking it as **Backorderable**.++To do so, simply **check** or **uncheck the box** in the **Backorderable** column in the associated row.++This setting saves automatically, so there’s **no need to click Update**.++<Warning>Only mark products as backorderable if you plan to restock them. Enabling backorders for discontinued or limited-stock items may result in customer service issues.</Warning>\ No newline at end of filediff --git a/docs/user/manage-products/stock-transfers.mdx b/docs/user/manage-products/stock-transfers.mdxindex 964fcd7fc2..3f1d8a4e17 100644--- a/docs/user/manage-products/stock-transfers.mdx+++ b/docs/user/manage-products/stock-transfers.mdx@@ -1,74 +1,64 @@---title: "Stock Transfers"-description: "How to do stock transfers in the Spree open-source eCommerce dashboard"+description: "Learn how to create stock transfers in the Spree Commerce."----Stock transfers are crucial for multi-warehouse e-commerce businesses as it enables seamless movement of inventory between locations, ensuring optimal stock levels and reducing the risk of overstocking or stockouts.+Stock transfers allow you to move inventory between stock locations - a critical feature for multi-warehouse operations. This helps keep inventory balanced across your network, improves fulfillment speed, and reduces shipping costs by positioning products closer to customers.-This improves order fulfillment efficiency, lowers shipping costs, and enhances customer satisfaction by routing products from the nearest warehouse.+<Note>+ Before you can create stock transfers, you must first set up additional stock locations.+ See: [<u>Settings → Locations</u>](https://spreecommerce.org/docs/user/settings/locations).+</Note>-### Stock Locations+## How to Create a Stock Transfer-By default, your store will only have one stock location, so before you can create stock transfers, you must add additional stock locations.+To create a new stock transfer, navigate to **Products → Stock → Stock Transfers**.-To do so, navigate to Locations found in Settings.+-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431856/docs/Manage%20Products/Stock%20Transfers/2.3.2.0.1_Stock_Transfers_-_Stock_Locations_ythnyj.png" />+Click **New Stock Transfer** in the top-right corner and you’ll be redirected to the stock transfer creation form.-Click on the blue ‘New Stock Location’ button found in the top right corner.+-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431857/docs/Manage%20Products/Stock%20Transfers/2.3.2.0.2_Stock_Transfers_-_New_Location_pscpqs.png" />+Here you’ll see two distinct sections that allow you to:-Add a name and the address of the warehouse and click ‘Create’.+## Configure Transfer Details-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431857/docs/Manage%20Products/Stock%20Transfers/2.3.2.0.3_Stock_Transfers_-_Name_and_Address_bee8kq.png" />+-You will now be able to transfer stock to your newly added warehouse.+At the top of the form, you can specify the details of the stock transfer:-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431857/docs/Manage%20Products/Stock%20Transfers/2.3.2.0.4_Stock_Transfers_-_Warehouse_Added_lssf8q.png" />+- **Origin Location**: Select the warehouse the stock will be transferred from+- **Destination Location**: Select the warehouse the stock will be transferred to+- **Reference (optional)**: Add a label or note to help identify the transfer (e.g., Q2 Restock - East Coast)-### Creating Stock Transfers+## Add Products to the Transfer-To create a stock transfer, navigate to the Stock tab of the admin dashboard found under Products, and click on Stock Transfers above the search bar.+-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431871/docs/Manage%20Products/Stock%20Transfers/2.3.2.1_Stock_Transfers_-_Navigate_To_Tab_qshlm9.png" />+At the bottom of the form is where you can add the products to be transfered.-If you haven’t made any stock transfers before, you’ll be greeted by a blank page, with a blue ‘New Stock Transfer’ button in the top right corner of the screen.+To do so, click **\+ Add Products** and a search window will open, allowing you to start typing a product name to find matching variants.-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431858/docs/Manage%20Products/Stock%20Transfers/2.3.2.2_Stock_Transfers_-_Stock_Transfers_Page_diij7n.png" />+-Click on the blue ‘New Stock Transfer’ button and you’ll be redirected to another page where you can begin creating the stock transfer.+Select a variant and then click **Add selected variant** to add it to the stock transfer.-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431867/docs/Manage%20Products/Stock%20Transfers/2.3.2.3_Stock_Transfers_-_New_Stock_Transfer_kenefy.png" />+-First, you must select the Origin location and the Destination location from the dropdowns.+Now simply enter the number of units to be transferred for each variant.-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431867/docs/Manage%20Products/Stock%20Transfers/2.3.2.4_Stock_Transfers_-_Select_Locations_d9jkj0.png" />+<Note>+ You can only transfer quantities that are currently in stock at the origin location.+</Note>-Optionally, you can add a reference to make the transfer more easily identifiable, e.g., for auditing purposes.+## Finalize the Transfer-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431868/docs/Manage%20Products/Stock%20Transfers/2.3.2.5_Stock_Transfers_-_Reference_tbjtgf.png" />+When you're ready:-Next, you should select the product variants you’d like to include in the transfers.+- Review the details+- Click **Create** to process the transfer-To do so, click on the ‘+ Add Products’ button which will open a small window where you can search for the product variants you want to add.+The inventory counts at each location will be updated immediately to reflect the transfer (assuming the physical movement of stock has already occurred) and a record of the transfer will be added to the Stock Transfers tab.-<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431868/docs/Manage%20Products/Stock%20Transfers/2.3.2.6_Stock_Transfers_-_Add_Products_ppohs3.png" />--Start typing in the name of the product to return a list of products matching the query.--<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431869/docs/Manage%20Products/Stock%20Transfers/2.3.2.7_Stock_Transfers_-_Search_Products_frppvf.png" />--Select the variants you want to add to the transfers and click ‘Add selected variant’.--Once you’ve add all the variants that should be included in the transfer, you need only adjust the quantity of each to be transferred.--Please Note: You cannot transfer more stock than you have available at the Origin location. Doing so will result in an error message.--<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431869/docs/Manage%20Products/Stock%20Transfers/2.3.2.8_Stock_Transfers_-_Adjust_Quantities_xpjmmp.png" />--After adjusting the quantities, all that’s left to do is to click the blue ‘Create’ button and the transfer will be processed.--<img alt="" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/w_1920/q_auto/v1734431870/docs/Manage%20Products/Stock%20Transfers/2.3.2.9_Stock_Transfers_-_Create_Transfer_xm1gg9.png" />--The stock levels at each warehouse will now be accurately reflected in the system, provided the physical transfer of the items has already been made.\ No newline at end of file+\ No newline at end of filediff --git a/docs/user/products/editing-products.mdx b/docs/user/products/editing-products.mdxindex 72c9530f64..ded8174f09 100644--- a/docs/user/products/editing-products.mdx+++ b/docs/user/products/editing-products.mdx@@ -13,10 +13,10 @@ There are many reasons you might need to update a product - whether it’s to coWhatever the reason, editing a product is straightforward and can be done at any time.--## How to Edit a Product++1. Go to the **Products** tab in the admin dashboard and click on the product you want to update.2. This opens the product editor, where you can modify any existing field or fill in previously empty ones.3. Make your changes as needed across the different sections (e.g., Pricing, Media, Inventory, etc.)