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.

Documentation edits made through Mintlify web editor

mintlify[bot]5fab5f114c37
diff --git a/docs/user/manage-products/product-options.mdx b/docs/user/manage-products/product-options.mdx
index 3f5b9e4ef7..da9f40e115 100644
--- a/docs/user/manage-products/product-options.mdx
+++ b/docs/user/manage-products/product-options.mdx
@@ -1,4 +1,110 @@
---
title: "Product Options"
description: "How to manage product options in the Spree open-source eCommerce dashboard"
----
\ No newline at end of file
+---
+
+Product options are product attributes like size, color, or material that allow customers to choose variations of a product.
+
+They enhance the user experience by making it easier to find and choose the desired product variant by acting as filters on the storefront, helping customers refine their searches more efficiently.
+
+Additionally, they can streamline inventory management by linking variations to a single product listing.
+
+To 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" />
+
+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.
+
+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" />
+
+### General Information
+
+In this section you can set the name of the Option as should be displayed on the storefront, as well as the Interal Name.
+
+If 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" />
+
+#### &#xA;Filterable
+
+In 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" />
+
+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" />
+
+### Option Values
+
+Option 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" />
+
+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" />
+
+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" />
+
+## Option Management
+
+Navigating 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" />
+
+### Option Ordering
+
+If 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" />
+
+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/v1734624483/docs/Manage%20Products/Product%20Options/2.5.11_Options_-_Original_Order_ytwoz9.png" />
+
+To this:
+
+<img alt="New Order" 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.12_Options_-_New_Order_ort199.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" />
+
+### Edit Options
+
+To 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" />
+
+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" />
+
+Once you’re finished, make sure to click the blue ‘Update’ button at the bottom of the page.
+
+### Delete Options
+
+To 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" />
+
+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" />
+
+## Import Options
+
+New Options Types and Option Values can be automatically imported if you add the appropriate values to the Option columns in a product import file.
+
+To learn more about imports, please refer to the [Product Import](https://spreecommerce.org/docs/user/manage-products/import-products) support article.
diff --git a/docs/user/manage-products/product-taxonomies.mdx b/docs/user/manage-products/product-taxonomies.mdx
index 385e7382f8..fef376f78e 100644
--- a/docs/user/manage-products/product-taxonomies.mdx
+++ b/docs/user/manage-products/product-taxonomies.mdx
@@ -207,7 +207,7 @@ If you’re store is multi-language, you can add translations for both taxonomie
To learn more about translations, please refer to another support article.
-## Real-Life Examples: Categories, Collections, and Brands
+## Real-Life Examples ofCategories, Collections, and Brands
1. [Industry-Specific Taxonomy Needs](https://spreecommerce.org/improving-product-discovery-and-conversions-with-product-taxonomies-categories-collections-and-brands/#Industry-Specific)
@@ -217,16 +217,4 @@ To learn more about translations, please refer to another support article.
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)
-
-## All about Product SEO
-
-1. [The SEO Power of Product Organization](https://spreecommerce.org/boost-ecommerce-seo-with-product-taxonomies-categories-collections-and-brands/#Product-SEO)
-
-2. [Understanding eCommerce Taxonomies](https://spreecommerce.org/boost-ecommerce-seo-with-product-taxonomies-categories-collections-and-brands/#eCommerce-Taxonomies)
-
-3. [Advanced Taxonomy Management](https://spreecommerce.org/boost-ecommerce-seo-with-product-taxonomies-categories-collections-and-brands/#Taxonomy-Management)
-
-4. [Maximizing Long Tail SEO](https://spreecommerce.org/boost-ecommerce-seo-with-product-taxonomies-categories-collections-and-brands/#Long-Tail-SEO)
-
-5. [Take Your Product Organization to the Next Level](https://spreecommerce.org/boost-ecommerce-seo-with-product-taxonomies-categories-collections-and-brands/#Product-Organization)
\ 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)
\ No newline at end of file