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]75a04dacf65b
diff --git a/docs/user/manage-products/product-properties.mdx b/docs/user/manage-products/product-properties.mdxindex 36f3d44215..8f2a3deeb3 100644--- a/docs/user/manage-products/product-properties.mdx+++ b/docs/user/manage-products/product-properties.mdx@@ -1,4 +1,104 @@---title: "Product Properties"description: "How to manage product properties in the Spree open-source eCommerce dashboard"----\ No newline at end of file+---++Product properties provide detailed specifications, such as dimensions, materials, care instructions, allergen warnings, etc., that help customers make informed purchase decisions.++They streamline inventory management by standardizing key product details across listings. Additionally, product properties enhance product listings by highlighting unique features that differentiate items from competitors.++To manage product Properties, navigate to the Properties tab of the admin dashboard found under Products.++<img alt="Product Properties" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626565/docs/Manage%20Products/Product%20Properties/2.6.1_Properties_-_Navigate_To_Tab_cnxdhz.png" />++This page lists all of the product properties added to your store, with columns indicating the kind of property, how many products have the property, and the visibilility of the property.++## Add a New Property++To add a new property, click ‘+ New Property’ in the top right corner.++This will open the property creation page.++<img alt="Add A New Property" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626565/docs/Manage%20Products/Product%20Properties/2.6.2_Properties_-_Add_A_New_Property_gnhjyk.png" />++### Presentation++In the top two fields, you can set the name of the property. Presentation is how the property will be displayed on the storefront.++If an Internal Name is not set, the Presentation name will be used.++<img alt="Presentation" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626564/docs/Manage%20Products/Product%20Properties/2.6.3_Properties_-_Presentation_jgnmsz.png" />++### Kind++Kind indicates the type of values the property field should store, e.g.:++* Short text++* Long text++* Number++* Rick Text++<img alt="Kind" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626565/docs/Manage%20Products/Product%20Properties/2.6.4_Properties_-_Kind_xkahvm.png" />++### Display++Controls where the Property will be displayed, i.e., for who is the information relevant:++* On both admin panel & storefront, i.e., useful for admins and customers++* Only on storefront, i.e., only useful for customers++* Only on admin panel, i.e., only useful for admins++<img alt="Display On" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626565/docs/Manage%20Products/Product%20Properties/2.6.5_Properties_-_Display_On_em37wp.png" />++If the product is visible on the storefront, it will be presented below the product description on PDPs if and only if the product has a non-empty value for that property field:++<img alt="Storefront" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626567/docs/Manage%20Products/Product%20Properties/2.6.6_Properties_-_Storefront_mh6yho.png" />++### Click Create++Once you’ve completed all of the fields, click the blue ‘Create’ button at the bottom of the page, and the property will be created.++<img alt="Click Create" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626566/docs/Manage%20Products/Product%20Properties/2.6.7_Properties_-_Click_Create_ppz4zn.png" />++## Properties Management++Navigating back to the Properties page, you’ll see that your newly created option is now listed among your other Properties.++<img alt="Management" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626565/docs/Manage%20Products/Product%20Properties/2.6.8_Properties_-_Management_dktdhj.png" />++### Properties Ordering++If you’d like to change the order in which properties are displayed on the storefront, e.g., 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="Ordering" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626573/docs/Manage%20Products/Product%20Properties/2.6.9_Properties_-_Ordering_cb9tpf.png" />++### Editing Properties++To edit a property, navigate to the Properties tab, and click ‘Edit’ on the property you’d like to edit.++<img alt="Edit A Property" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626573/docs/Manage%20Products/Product%20Properties/2.6.10_Properties_-_Edit_A_Property_gharxz.png" />++Feel free to change the Presentation Name, Internal Name, Kind, and Display On fields.++<img alt="Make Changes and Update" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626573/docs/Manage%20Products/Product%20Properties/2.6.11_Properties_-_Make_Changes_and_Update_dddcou.png" />++Once you’re finished, make sure to click the blue ‘Update’ button at the bottom of the page.++#### Delete Properties++To delete a property, navigate to the Properties tab, and click ‘Edit’ on the property you’d like to delete.++On the property editor page, locate the red ‘Delete’ button at the bottom of the page and the property will be deleted.++<img alt="Delete A Property" classname="block dark:hidden" src="https://vendo-production-res.cloudinary.com/image/upload/v1734626574/docs/Manage%20Products/Product%20Properties/2.6.12_Properties_-_Delete_A_Property_vfengh.png" />++## Import Properties++Properties can be automatically imported if you add the appropriate values to the properties columns in a product import file.++To learn more about imports, please refer to the [Product Imports](https://spreecommerce.org/docs/user/manage-products/import-products) support article.\ No newline at end of file