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]27ac22c6853e
diff --git a/docs/user/manage-products/product-taxonomies.mdx b/docs/user/manage-products/product-taxonomies.mdxindex 0062a8e036..9fc277a8f3 100644--- a/docs/user/manage-products/product-taxonomies.mdx+++ b/docs/user/manage-products/product-taxonomies.mdx@@ -1,4 +1,208 @@---title: "Product Taxonomies"-description: "How to manage product taxonomies in the Spree dashboard"----\ No newline at end of file+description: "How to manage product taxonomies in the Spree open-source eCommerce dashboard"+---++Taxonomies let you organizing 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.++<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++### 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.++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" />++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" />++### 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.++<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.++#### Presentation++There 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++#### Taxon Type++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" />++##### Manual Taxons++As the name suggests, you must add products manually, either by assigning products to the taxon in bulk, curating them one by one, or by adding the appropriate values to the category column when importing a product file.++##### Automatic Taxons++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" />++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++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" />++Feel free to add more conditions to further curate the taxon by clicking onn ‘+ 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" />++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" />++#### 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" />++#### 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 alt="" 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.++<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" />++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" />++#### Sort Order++For merchandising purposes, you may want to change the order in which products in a taxon are presented in the storefront.++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" />++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" />++Important: Make sure to hit ‘Update’ at the bottom of the page if you want to save any changes you’ve made to taxon.++### 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’.++<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" />++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" />++### Import Taxons++Taxons 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++To learn more about imports, please refer to the [Import Products](https://spreecommerce.org/docs/user/manage-products/import-products) article.++### Editing Taxonomies++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" />++Find the taxonomy you’d like to rename, and click the Edit button the far right side.++<img alt="" 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’.++### 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 alt="" 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.++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.++### Translations++If you’re store is multi-language, you can add translations for both taxonomies and taxons.++To learn more about translations, please refer to another support article.\ No newline at end of file