Skip to content

armgit / spree

Public Imported from GitHub
0

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.

Updated taxonomies user doc (#13259)

jaburghese6a239267e4d
diff --git a/docs/images/user/products/taxonomies/1.tab.png b/docs/images/user/products/taxonomies/1.tab.png
new file mode 100644
index 0000000000..037fce23ef
Binary files /dev/null and b/docs/images/user/products/taxonomies/1.tab.png differ
diff --git a/docs/images/user/products/taxonomies/10.add-products .png b/docs/images/user/products/taxonomies/10.add-products .png
new file mode 100644
index 0000000000..25a69d4ae5
Binary files /dev/null and b/docs/images/user/products/taxonomies/10.add-products .png differ
diff --git a/docs/images/user/products/taxonomies/11.select-products.png b/docs/images/user/products/taxonomies/11.select-products.png
new file mode 100644
index 0000000000..9418077b97
Binary files /dev/null and b/docs/images/user/products/taxonomies/11.select-products.png differ
diff --git a/docs/images/user/products/taxonomies/12.products-added.png b/docs/images/user/products/taxonomies/12.products-added.png
new file mode 100644
index 0000000000..7abb689256
Binary files /dev/null and b/docs/images/user/products/taxonomies/12.products-added.png differ
diff --git a/docs/images/user/products/taxonomies/13.sort-order.png b/docs/images/user/products/taxonomies/13.sort-order.png
new file mode 100644
index 0000000000..eeec7b3751
Binary files /dev/null and b/docs/images/user/products/taxonomies/13.sort-order.png differ
diff --git a/docs/images/user/products/taxonomies/14.manual-ordering.png b/docs/images/user/products/taxonomies/14.manual-ordering.png
new file mode 100644
index 0000000000..211d7e6921
Binary files /dev/null and b/docs/images/user/products/taxonomies/14.manual-ordering.png differ
diff --git a/docs/images/user/products/taxonomies/15.nested-taxons.png b/docs/images/user/products/taxonomies/15.nested-taxons.png
new file mode 100644
index 0000000000..02278e711c
Binary files /dev/null and b/docs/images/user/products/taxonomies/15.nested-taxons.png differ
diff --git a/docs/images/user/products/taxonomies/16.taxonomy-tree.png b/docs/images/user/products/taxonomies/16.taxonomy-tree.png
new file mode 100644
index 0000000000..72ac12ef9f
Binary files /dev/null and b/docs/images/user/products/taxonomies/16.taxonomy-tree.png differ
diff --git a/docs/images/user/products/taxonomies/17.move-taxons.png b/docs/images/user/products/taxonomies/17.move-taxons.png
new file mode 100644
index 0000000000..fc2f895ccc
Binary files /dev/null and b/docs/images/user/products/taxonomies/17.move-taxons.png differ
diff --git a/docs/images/user/products/taxonomies/18.edit-taxonomies.png b/docs/images/user/products/taxonomies/18.edit-taxonomies.png
new file mode 100644
index 0000000000..e9996a403f
Binary files /dev/null and b/docs/images/user/products/taxonomies/18.edit-taxonomies.png differ
diff --git a/docs/images/user/products/taxonomies/19.renamed-taxonomy.png b/docs/images/user/products/taxonomies/19.renamed-taxonomy.png
new file mode 100644
index 0000000000..d427f4ac74
Binary files /dev/null and b/docs/images/user/products/taxonomies/19.renamed-taxonomy.png differ
diff --git a/docs/images/user/products/taxonomies/2.new-taxonomy.png b/docs/images/user/products/taxonomies/2.new-taxonomy.png
new file mode 100644
index 0000000000..967989f43d
Binary files /dev/null and b/docs/images/user/products/taxonomies/2.new-taxonomy.png differ
diff --git a/docs/images/user/products/taxonomies/20.taxonomy-created.png b/docs/images/user/products/taxonomies/20.taxonomy-created.png
new file mode 100644
index 0000000000..cd8a735491
Binary files /dev/null and b/docs/images/user/products/taxonomies/20.taxonomy-created.png differ
diff --git a/docs/images/user/products/taxonomies/3.new-taxon.png b/docs/images/user/products/taxonomies/3.new-taxon.png
new file mode 100644
index 0000000000..f818eea476
Binary files /dev/null and b/docs/images/user/products/taxonomies/3.new-taxon.png differ
diff --git a/docs/images/user/products/taxonomies/4.taxon-type.png b/docs/images/user/products/taxonomies/4.taxon-type.png
new file mode 100644
index 0000000000..9fb462a914
Binary files /dev/null and b/docs/images/user/products/taxonomies/4.taxon-type.png differ
diff --git a/docs/images/user/products/taxonomies/5.automatic-taxons.png b/docs/images/user/products/taxonomies/5.automatic-taxons.png
new file mode 100644
index 0000000000..332e7a6e6b
Binary files /dev/null and b/docs/images/user/products/taxonomies/5.automatic-taxons.png differ
diff --git a/docs/images/user/products/taxonomies/6.condition-values.png b/docs/images/user/products/taxonomies/6.condition-values.png
new file mode 100644
index 0000000000..7522c34424
Binary files /dev/null and b/docs/images/user/products/taxonomies/6.condition-values.png differ
diff --git a/docs/images/user/products/taxonomies/7.navigation.png b/docs/images/user/products/taxonomies/7.navigation.png
new file mode 100644
index 0000000000..07a7f131e2
Binary files /dev/null and b/docs/images/user/products/taxonomies/7.navigation.png differ
diff --git a/docs/images/user/products/taxonomies/8.navigation-filtering.png b/docs/images/user/products/taxonomies/8.navigation-filtering.png
new file mode 100644
index 0000000000..4ece809495
Binary files /dev/null and b/docs/images/user/products/taxonomies/8.navigation-filtering.png differ
diff --git a/docs/images/user/products/taxonomies/9.seo.png b/docs/images/user/products/taxonomies/9.seo.png
new file mode 100644
index 0000000000..f42e847d5e
Binary files /dev/null and b/docs/images/user/products/taxonomies/9.seo.png differ
diff --git a/docs/user/manage-products/product-taxonomies.mdx b/docs/user/manage-products/product-taxonomies.mdx
index cadc961707..82891a7e96 100644
--- a/docs/user/manage-products/product-taxonomies.mdx
+++ b/docs/user/manage-products/product-taxonomies.mdx
@@ -1,21 +1,17 @@
---
title: "Product Taxonomies"
-description: "How to manage product taxonomies in the Spree open-source eCommerce dashboard"
+description: "How to manage product taxonomies in the Spree Commerce dashboard"
---
-Taxonomies let you organizing products into groups like categories, brands, or collections.
+Taxonomies let you organize products into groups like categories, brands, or collections.
Taxons are individual nodes or items within a taxonomy, representing specific groups like a category, subcategory, or brand.
A well-designed taxonomy enhances search functionality, improves user experience, and boosts sales by guiding customers through a logical and intuitive shopping journey.
-To setup taxonomies for your store, navigate to the Taxomonies tab of the admin dashboard, found under Products.
+To setup taxonomies for your store, navigate to the Taxonomies 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"
-/>
+![](/docs/images/user/products/taxonomies/1.tab.png)
Here you will see three automatically created taxonomies that are commonly used in ecommerce:
@@ -25,37 +21,23 @@ Here you will see three automatically created taxonomies that are commonly used
## Add a New Taxonomy
-To add a new Taxonomy, such as a Category, Collection, or Brand, click on the blue button in the top right corner.
+To add a new Taxonomy, such as a Category, Collection, or Brand, click **New Taxon** in the top right corner.
This 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"
-/>
+![](/docs/images/user/products/taxonomies/2.new-taxonomy.png)
-Enter the name, and click the blue ‘Create’ button and youll receive a notification that the taxonomy has been successfully created.
+Enter the name, and click the **Create** to finalize creation of the taxonomy and you'll be redirected to a page that allows you to manage the new taxonomy.
-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"
-/>
+![](/docs/images/user/products/taxonomies/20.taxonomy-created.png)
## Add Taxons
With 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 **New Taxon** 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"
-/>
+![](/docs/images/user/products/taxonomies/4.new-taxon.png)
This opens up the taxon editor page which allows you to define the taxon and add media.
@@ -72,11 +54,7 @@ There are four sections that affect how the taxon is presented on the storefront
Taxon 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"
-/>
+![](/docs/images/user/products/taxonomies/4.taxon-type.png)
#### Manual Taxons
@@ -86,99 +64,62 @@ As the name suggests, you must add products manually, either by assigning produc
Allows 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"
-/>
+![](/docs/images/user/products/taxonomies/5.automatic-taxons.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
+- Product tag - products will only be included if they have a matching 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
Once 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"
-/>
+![](/docs/images/user/products/taxonomies/6.condition-values.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 **Add One**.
### Navigation
Here 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"
-/>
+![](/docs/images/user/products/taxonomies/7.navigation.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.
+The dropdown list will show a list of all taxons available within the taxonomy you're 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"
-/>
+![](/docs/images/user/products/taxonomies/8.navigation-filtering.png)
### Search Engine Listing
Here 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"
-/>
+![](/docs/images/user/products/taxonomies/9.seo.png)
### Create Taxon
-Once 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"
-/>
+Once you’ve added the name and defined the taxon type, click **Create** at the bottom of the page to create the taxon, and you’ll receive a notification that the taxon was successfully created.
### 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.
-
-<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"
-/>
+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.
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.
+![](/docs/images/user/products/taxonomies/10.add-products.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"
-/>
+Start typing to show suggested products, then simply check the boxes of the products you’d like to add and then click **Add selected products**
-You’ll then see those products listed in the Products section of the taxon editor.
+![](/docs/images/user/products/taxonomies/11.select-products.png)
-Note: You can removed individual products by clicking on the red trash can button in the far right column.
+You should now see those products listed in the Products section of the taxon editor.
-<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"
-/>
+<note>You can remove individual products by clicking on the **red trash can button** in the far right column.</note>
+
+![](/docs/images/user/products/taxonomies/12.products-added.png)
### Sort Order
@@ -186,51 +127,31 @@ For merchandising purposes, you may want to change the order in which products i
To 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"
-/>
+![](/docs/images/user/products/taxonomies/13.sort-order.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"
-/>
+![](/docs/images/user/products/taxonomies/14.manual-ordering.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.
+<note>Make sure to click **Update** at the bottom of the page if you want to save any changes you’ve made to taxon.</note>
## Build A Taxonomy Tree
If 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's row 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"
-/>
+![](/docs/images/user/products/taxonomies/15.nested-taxons.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"
-/>
+![](/docs/images/user/products/taxonomies/16.taxonomy-tree.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"
-/>
+![](/docs/images/user/products/taxonomies/17.move-taxons.png)
## Import Taxons
@@ -247,33 +168,21 @@ To learn more about imports, please refer to the [Import Products](https://spree
If 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"
-/>
+![](/docs/images/user/products/taxonomies/18.edit-taxonomies.png)
-Find the taxonomy you’d like to rename, and click the Edit button the far right side.
+Find the taxonomy you’d like to rename, and click **Edit** on 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"
-/>
+![](/docs/images/user/products/taxonomies/19.renamed-taxonomy.png)
-Simply rename the taxonomy and click ‘Update’.
+Enter the new taxonomy name and click **Update** to save changes.
## Editing Taxons
-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"
-/>
+To edit a taxon, find the taxon you’d like to edit in its respective taxonomy, and click the **Edit** button on the taxon's row.
-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.
+Feel free to edit the name and description, swap out images, change the nesting, and update search engine listing settings. Make sure to click **Update** to save your changes.
-Important: You cannot edit the Taxon Type of a taxon once created. If you want to change a taxon from manual to automatic (or vice versa), delete the old taxon and create another.
+<note>You cannot edit the Taxon Type of a taxon once created. If you want to change a taxon from manual to automatic (or vice versa), delete the old taxon and create another one with the same name.</note>
## Translations
@@ -287,4 +196,4 @@ To learn more about translations, please refer to another support article.
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 file
+5. [Taxonomy Tools](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Taxonomy-Tools)