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 user docs covering the Settings menu (#13284)

jaburghes7edfdcd8287c
diff --git a/docs/images/user/settings/locations/1-stock-locations.png b/docs/images/user/settings/locations/1-stock-locations.png
new file mode 100644
index 0000000000..1473e21255
Binary files /dev/null and b/docs/images/user/settings/locations/1-stock-locations.png differ
diff --git a/docs/images/user/settings/locations/10.13.1Locations-NavigateToTab.png b/docs/images/user/settings/locations/10.13.1Locations-NavigateToTab.png
deleted file mode 100644
index 7317d09d45..0000000000
Binary files a/docs/images/user/settings/locations/10.13.1Locations-NavigateToTab.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/10.13.2Locations-CreateaNewLocation.png b/docs/images/user/settings/locations/10.13.2Locations-CreateaNewLocation.png
deleted file mode 100644
index 04a7fc26c3..0000000000
Binary files a/docs/images/user/settings/locations/10.13.2Locations-CreateaNewLocation.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/10.13.3Locations-LocationCreated.png b/docs/images/user/settings/locations/10.13.3Locations-LocationCreated.png
deleted file mode 100644
index d9e25a69f3..0000000000
Binary files a/docs/images/user/settings/locations/10.13.3Locations-LocationCreated.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/10.13.4Locations-SetDefaultLocation.png b/docs/images/user/settings/locations/10.13.4Locations-SetDefaultLocation.png
deleted file mode 100644
index 21ff575674..0000000000
Binary files a/docs/images/user/settings/locations/10.13.4Locations-SetDefaultLocation.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/10.13.5Locations-DeleteLocation.png b/docs/images/user/settings/locations/10.13.5Locations-DeleteLocation.png
deleted file mode 100644
index 59a1779f06..0000000000
Binary files a/docs/images/user/settings/locations/10.13.5Locations-DeleteLocation.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/10.13.6Locations-LocationDeleted.png b/docs/images/user/settings/locations/10.13.6Locations-LocationDeleted.png
deleted file mode 100644
index 7320921426..0000000000
Binary files a/docs/images/user/settings/locations/10.13.6Locations-LocationDeleted.png and /dev/null differ
diff --git a/docs/images/user/settings/locations/2-create-stock-location.png b/docs/images/user/settings/locations/2-create-stock-location.png
new file mode 100644
index 0000000000..96b6069176
Binary files /dev/null and b/docs/images/user/settings/locations/2-create-stock-location.png differ
diff --git a/docs/images/user/settings/locations/3-stock-location-created.png b/docs/images/user/settings/locations/3-stock-location-created.png
new file mode 100644
index 0000000000..09897155de
Binary files /dev/null and b/docs/images/user/settings/locations/3-stock-location-created.png differ
diff --git a/docs/images/user/settings/locations/4-set-default-location.png b/docs/images/user/settings/locations/4-set-default-location.png
new file mode 100644
index 0000000000..80fb155621
Binary files /dev/null and b/docs/images/user/settings/locations/4-set-default-location.png differ
diff --git a/docs/images/user/settings/locations/5-delete-stock-location.png b/docs/images/user/settings/locations/5-delete-stock-location.png
new file mode 100644
index 0000000000..1016426bfc
Binary files /dev/null and b/docs/images/user/settings/locations/5-delete-stock-location.png differ
diff --git a/docs/images/user/settings/policies/1-policies-tab.png b/docs/images/user/settings/policies/1-policies-tab.png
new file mode 100644
index 0000000000..fcfc1b9627
Binary files /dev/null and b/docs/images/user/settings/policies/1-policies-tab.png differ
diff --git a/docs/images/user/settings/policies/2-policy-form.png b/docs/images/user/settings/policies/2-policy-form.png
new file mode 100644
index 0000000000..de3476f0a3
Binary files /dev/null and b/docs/images/user/settings/policies/2-policy-form.png differ
diff --git a/docs/images/user/settings/policies/3-policy-published.png b/docs/images/user/settings/policies/3-policy-published.png
new file mode 100644
index 0000000000..21c2811874
Binary files /dev/null and b/docs/images/user/settings/policies/3-policy-published.png differ
diff --git a/docs/images/user/settings/policies/policies.png b/docs/images/user/settings/policies/policies.png
deleted file mode 100644
index d84643ffd6..0000000000
Binary files a/docs/images/user/settings/policies/policies.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/1-shipping-methods.png b/docs/images/user/settings/shipping/1-shipping-methods.png
new file mode 100644
index 0000000000..02a61b3140
Binary files /dev/null and b/docs/images/user/settings/shipping/1-shipping-methods.png differ
diff --git a/docs/images/user/settings/shipping/10.10.1.10Shipping-MethodCreated.png b/docs/images/user/settings/shipping/10.10.1.10Shipping-MethodCreated.png
deleted file mode 100644
index eeca9eda7c..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.10Shipping-MethodCreated.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.1Shipping-NavigateToTab.png b/docs/images/user/settings/shipping/10.10.1.1Shipping-NavigateToTab.png
deleted file mode 100644
index 98ed9aca4e..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.1Shipping-NavigateToTab.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.2Shipping-AddANewShippingMethod.png b/docs/images/user/settings/shipping/10.10.1.2Shipping-AddANewShippingMethod.png
deleted file mode 100644
index 3b1ef2c67b..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.2Shipping-AddANewShippingMethod.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.3Shipping-Presentation.png b/docs/images/user/settings/shipping/10.10.1.3Shipping-Presentation.png
deleted file mode 100644
index 6069d5a8ca..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.3Shipping-Presentation.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.4Shipping-TrackingURL.png b/docs/images/user/settings/shipping/10.10.1.4Shipping-TrackingURL.png
deleted file mode 100644
index 2f861b319f..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.4Shipping-TrackingURL.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.5Shipping-Zones.png b/docs/images/user/settings/shipping/10.10.1.5Shipping-Zones.png
deleted file mode 100644
index 202faa43a3..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.5Shipping-Zones.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.6Shipping-ShippingCategories.png b/docs/images/user/settings/shipping/10.10.1.6Shipping-ShippingCategories.png
deleted file mode 100644
index 49cb7b9b2a..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.6Shipping-ShippingCategories.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.7Shipping-TaxCategory.png b/docs/images/user/settings/shipping/10.10.1.7Shipping-TaxCategory.png
deleted file mode 100644
index 101377a415..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.7Shipping-TaxCategory.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.8Shipping-Calculator.png b/docs/images/user/settings/shipping/10.10.1.8Shipping-Calculator.png
deleted file mode 100644
index 9c2badf476..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.8Shipping-Calculator.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/10.10.1.9Shipping-EstimatedTransit.png b/docs/images/user/settings/shipping/10.10.1.9Shipping-EstimatedTransit.png
deleted file mode 100644
index 4f83a9c316..0000000000
Binary files a/docs/images/user/settings/shipping/10.10.1.9Shipping-EstimatedTransit.png and /dev/null differ
diff --git a/docs/images/user/settings/shipping/2-new-shipping-method.png b/docs/images/user/settings/shipping/2-new-shipping-method.png
new file mode 100644
index 0000000000..d07673906e
Binary files /dev/null and b/docs/images/user/settings/shipping/2-new-shipping-method.png differ
diff --git a/docs/images/user/settings/shipping/3-shipping-method-presentation.png b/docs/images/user/settings/shipping/3-shipping-method-presentation.png
new file mode 100644
index 0000000000..d16272bf99
Binary files /dev/null and b/docs/images/user/settings/shipping/3-shipping-method-presentation.png differ
diff --git a/docs/images/user/settings/shipping/4-tracking-url.png b/docs/images/user/settings/shipping/4-tracking-url.png
new file mode 100644
index 0000000000..7b2b9f7b42
Binary files /dev/null and b/docs/images/user/settings/shipping/4-tracking-url.png differ
diff --git a/docs/images/user/settings/shipping/5-shipping-method-zones.png b/docs/images/user/settings/shipping/5-shipping-method-zones.png
new file mode 100644
index 0000000000..81c01fd1a3
Binary files /dev/null and b/docs/images/user/settings/shipping/5-shipping-method-zones.png differ
diff --git a/docs/images/user/settings/shipping/6-shipping-categories.png b/docs/images/user/settings/shipping/6-shipping-categories.png
new file mode 100644
index 0000000000..38499af95e
Binary files /dev/null and b/docs/images/user/settings/shipping/6-shipping-categories.png differ
diff --git a/docs/images/user/settings/shipping/7-tax-category.png b/docs/images/user/settings/shipping/7-tax-category.png
new file mode 100644
index 0000000000..cb4716f8ad
Binary files /dev/null and b/docs/images/user/settings/shipping/7-tax-category.png differ
diff --git a/docs/images/user/settings/shipping/8-shipping-calculator.png b/docs/images/user/settings/shipping/8-shipping-calculator.png
new file mode 100644
index 0000000000..1c08e639f1
Binary files /dev/null and b/docs/images/user/settings/shipping/8-shipping-calculator.png differ
diff --git a/docs/images/user/settings/shipping/9-estimated-delivery.png b/docs/images/user/settings/shipping/9-estimated-delivery.png
new file mode 100644
index 0000000000..05c55a3d8f
Binary files /dev/null and b/docs/images/user/settings/shipping/9-estimated-delivery.png differ
diff --git a/docs/user/settings/locations.mdx b/docs/user/settings/locations.mdx
index 8ca50611cd..5d850f848b 100644
--- a/docs/user/settings/locations.mdx
+++ b/docs/user/settings/locations.mdx
@@ -1,46 +1,44 @@
---
title: "Locations"
-description: "In this Spree user doc, you'll learn how to create and manage stock locations."
+description: "Learn how to create and manage stock locations in Spree Commerce."
---
For large businesses with multiple warehouses, the ability to add multiple stock locations is essential for efficiently managing inventory across different regions. 
It ensures accurate stock tracking, optimizes order fulfillment, and enables faster shipping by routing orders from the nearest warehouse.
-To set up and manage stock locations, navigate to the Locations tab of the Settings menu.
+To set up and manage stock locations, navigate to **Settings → Locations**.
-<img src="/images/user/settings/locations/10.13.1Locations-NavigateToTab.png" />
+![](/docs/images/user/settings/locations/1-stock-locations.png)
## Add a New Location
-To add a new Location, click on the 'New Stock Location' button in the top right corner. This will open the Location creation page.
+To add a new Location, click on **New Stock Location** in the top right corner. This will open the Location creation form.
-<img src="/images/user/settings/locations/10.13.2Locations-CreateaNewLocation.png" />
+![](/docs/images/user/settings/locations/2-create-stock-location.png)
-Simply enter a name, the address, and (optionally) a phone number, and click then click the 'Create' button at the bottom of the page to create the Location.
+Simply enter a name, company name, the address, and (optionally) a phone number, and click then click **Create** at the bottom of the page to create the Location.
The new Location will now be added to your list of stock locations.
-<img src="/images/user/settings/locations/10.13.3Locations-LocationCreated.png" />
+![](/docs/images/user/settings/locations/3-stock-location-created.png)
## Edit a Location
-To edit a Location, simply click the ‘Edit’ button on the right side of the Location’s row, and update the information as necessary.
+To edit a Location, simply click **Edit** on the right-hand side of the Location’s row, and update the information as necessary.
## Set a Default Location
-To set your default Location, click the three dots on the right hand side of the Location’s row and select 'Mark as default' from the menu.
+To set your default Location, click the **three-dot menu** on the right-hand side of the Location’s row and select **Mark as default** from the menu.
-<img src="/images/user/settings/locations/10.13.4Locations-SetDefaultLocation.png" />
+![](/docs/images/user/settings/locations/4-set-default-location.png)
## Delete a Location
-To delete a Location, click the 'Edit' button on the right side of the Location’s row to open the Location editor, and find the ‘Delete’ button at the bottom of the page.
+To delete a Location, click **Edit** on the right side of the Location’s row to open the Location edit form, and click **Delete** at the bottom of the page.
-<img src="/images/user/settings/locations/10.13.5Locations-DeleteLocation.png" />
+![](/docs/images/user/settings/locations/5-delete-stock-location.png)
-Click ‘Delete’ and the Location will be removed from your list of stock locations.
+The Location will then be removed from your list of stock locations.
-<img src="/images/user/settings/locations/10.13.6Locations-LocationDeleted.png" />
-
-Congratulations, you now know how to create, edit, and delete stock locations!
\ No newline at end of file
+Congratulations, you now know how to create, edit, and delete stock locations!
diff --git a/docs/user/settings/policies.mdx b/docs/user/settings/policies.mdx
index 3f1127885c..a4aeb79562 100644
--- a/docs/user/settings/policies.mdx
+++ b/docs/user/settings/policies.mdx
@@ -1,40 +1,58 @@
---
title: "Policies"
-description: "In this Spree user doc, you’ll learn how to set your store’s policies."
+description: "Learn how to set up and manage store policies in Spree Commerce."
---
-Policies help define the rules of engagement between your store and your customers. They’re not just legal safeguards - they also build trust and set expectations. 
+Your store policies are an essential part of your eCommerce setup, helping you establish trust, maintain compliance, and communicate clearly with your customers. Spree allows you to easily manage these pages from the Policies tab.
-All policies added here will appear in your store’s footer and will be available to customers during checkout.
+You can create as many custom policy pages as you need, with full control over their content and URL structure.
-To set up your store policies, navigate to the Policies tab of the Settings menu.
+The following four standard policies are added to every store by default:
-<img src="/images/user/settings/policies/policies.png" />
+- Terms of Service
+- Privacy Policy
+- Returns Policy
+- Shipping Policy
-In each case, simply copy and paste (or type) your policy into the associated text editor. Formatting is usually preserved when pasting, but you can also use the rich text editor tools to adjust the layout or style of your policies as needed.
+These can be customized, deleted, or supplemented with additional policies depending on your business needs.
-## Terms of Service
+## Create a New Policy
-This is a legal agreement between you and your customers. It outlines how your store operates, acceptable use, disclaimers, and liability limitations. Customers must accept it at signup. It's important for protecting your business in the event of disputes.
+To create a new policy, navigate to **Settings → Policies** in your Spree dashboard.
-## Privacy Policy
+![Spree Commerce policies tab](/docs/images/user/settings/policies/1-policies-tab.png)
-This explains how customer data is collected, stored, and used. It's a legal requirement in most regions (like GDPR in the EU) and reassures customers that their data is handled responsibly.
+Click **New Policy** in the top-right corner to open the policy creation form.
-## Returns Policy
+![Creating a new store policy in Spree Commerce](/docs/images/user/settings/policies/2-policy-form.png)
-Clearly states the conditions under which customers can return products. This reduces support queries and helps avoid misunderstandings. A transparent policy can also increase customer confidence and conversion rates.
+Simply enter data into the following fields:
-## Shipping Policy
+- **Name** - displayed title on the storefront.
+- **Slug** - URL identifier (e.g. /policies/custom-warranty).
+- **Content** - enter your policy text using the rich text editor (supports formatting, links, media, etc.).
-Provides details about delivery times, methods, and costs. It helps manage customer expectations and avoid frustration caused by delays or unexpected charges.
+Then, click **Create** to save and publish your new policy.
-## Vendor Terms of Service (For marketplaces)
+Once published, the policy will be accessible from the storefront and can also be linked in your footer navigation or other relevant areas.
-<Warning>The Vendor Terms of Service policy is only available (and relevant) to Spree Enterprise users running marketplaces.</Warning>
+![Published store policy on Spree storefront](/docs/images/user/settings/policies/3-policy-published.png)
-If you’re running a multi-vendor marketplace, this sets the rules vendors must agree to in order to sell on your platform. It could cover commission structure, responsibilities, content standards, and any platform-specific rules. This is essential for keeping vendor operations consistent and enforceable.
+## Edit an Existing Policy
-## Saving Changes
+To edit an existing policy, navigate to **Settings → Policies** and follow these steps:
-After making any updates, click Update at the bottom of the page to save your policy settings, otherwise any changes you’ve made will not be saved.
\ No newline at end of file
+1. Click on the policy you’d like to update.
+2. Modify the name, slug, or content as needed.
+3. Click **Update** to save your changes.
+
+Your edits will be reflected immediately on the live storefront.
+
+## Delete a Policy
+
+To delete an existing policy, navigate to **Settings → Policies** and follow these steps:
+
+1. Click on the policy you’d like to delete.
+2. Click **Delete** at  the bottom of the page and confirm.
+
+<Warning>Deleted policies are permanently removed and will no longer be accessible to customers.</Warning>
diff --git a/docs/user/settings/shipping-methods.mdx b/docs/user/settings/shipping-methods.mdx
index 0f3ee985b3..485cc4f7af 100644
--- a/docs/user/settings/shipping-methods.mdx
+++ b/docs/user/settings/shipping-methods.mdx
@@ -1,39 +1,35 @@
---
title: "Shipping Methods"
-description: "In this Spree user doc, you'll learn how to setup up shipping methods for your store."
+description: "Learn how to set up shipping methods in Spree Commerce."
---
If you want to run a successful online business, having shipping methods in place is essential. These methods appear at checkout, representing the carriers and services used to deliver your products to customers.
-<Warning>
- If you don’t set up at least one shipping method for each region you sell to, customers in those regions won’t be able to complete their checkout.
-</Warning>
+<Warning>If you don’t set up at least one shipping method for each region you sell to, customers in those regions won’t be able to complete their checkout.</Warning>
-To set up shipping methods, navigate to the Shipping tab of the admin dashboard, found in Settings menu.
+To set up shipping methods, navigate to **Settings → Shipping** in the Spree dashboard.
-![](/images/user/settings/shipping/10.10.1.1Shipping-NavigateToTab.png)
+![Shipping section of the Spree dashboard](/docs/images/user/settings/shipping/1-shipping-methods.png)
## Add a New Shipping Method
-To add a new shipping method, click 'New Shipping Method’ in the top right corner. This will open the shipping method creation page.
+To add a new shipping method, click **New Shipping Method** in the top right corner. This will open the shipping method creation form.
-![](/images/user/settings/shipping/10.10.1.2Shipping-AddANewShippingMethod.png)
+![Adding a new shipping method in Spree](/docs/images/user/settings/shipping/2-new-shipping-method.png)
-This page is divided into seven sections, so let’s take a look at each individually.
+This page is divided into seven distinct sections, so let’s take a look at each individually:
### Presentation
-![](/images/user/settings/shipping/10.10.1.3Shipping-Presentation.png)
+![Spree shipping methods presentation settings](/docs/images/user/settings/shipping/3-shipping-method-presentation.png)
-Here you can set a descriptive name for the shipping method (e.g., UPS Standard, Fed Ex Next Day), and choose where it should be displayed.
+Here you can set a descriptive name for the shipping method (e.g., UPS Standard, FedEx Next Day), and choose where it should be displayed.
-<Warning>
- Make sure the ‘Display on’ setting includes ‘storefront’ if you want customers to see this shipping method on the checkout.
-</Warning>
+<Warning>Make sure the **Display on** setting includes **storefront** if you want customers to see this shipping method on the checkout.</Warning>
### Tracking URL
-![](/images/user/settings/shipping/10.10.1.4Shipping-TrackingURL.png)
+![Spree shipping method tracking url](/docs/images/user/settings/shipping/4-tracking-url.png)
Here you can add the tracking URL format for the shipping carrier that’s associated with the payment method, e.g.:
@@ -41,71 +37,71 @@ Here you can add the tracking URL format for the shipping carrier that’s assoc
- [<u>https://www.ups.com/track?loc=en_US&tracknum=:tracking</u>](https://www.ups.com/track?loc=en_US&tracknum=:tracking)
- [<u>https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=:tracking</u>](https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=:tracking)
-This way, you can simply enter the tracking number when fulfilling an order that’s using the shipping method, and the customer will receive the correct tracking link to track their order.\
-\
-<Warning>
- Make sure to verify the tracking link format for each shipping carrier you plan on using and test them before going live.
-</Warning>
+This way, you can simply enter the tracking number when fulfilling an order that’s using the associated shipping method, and the customer will receive the correct tracking link for their order.
+<Warning>Make sure to verify the tracking link format for each shipping carrier you plan on using and test them before going live.</Warning>
### Zones
-![](/images/user/settings/shipping/10.10.1.5Shipping-Zones.png)
+![Set shipping zones in Spree Commerce](/docs/images/user/settings/shipping/5-shipping-method-zones.png)
-Even if you sell to multiple regions, not every shipping method should be available in every country. With Zones, you can set regional restrictions to control where each shipping method applies. Simply select the appropriate Zones for each method.
+Not all shipping methods should be available in every region - especially if you serve customers across multiple countries or continents. Zones allow you to define regional availability for each shipping method.
-<Note>
- Customers will only see shipping methods that apply to their delivery address based on the assigned Zones.
-</Note>
+Simply select the appropriate Zone(s) to ensure the method only appears for customers in those regions. This helps you prevent invalid shipping options and tailor your delivery strategy to each market.
-### Shipping Categories
+<Note>Customers will only see shipping methods that apply to their delivery address based on the assigned Zones.</Note>
-![](/images/user/settings/shipping/10.10.1.6Shipping-ShippingCategories.png)
+### Shipping Categories
-Shipping Categories allow you to specify which products a shipping method applies to.
+![Choose shipping categories in Spree Commerce](/docs/images/user/settings/shipping/6-shipping-categories.png)
-For example:
+Shipping Categories are especially useful when your store includes products with very different delivery needs. For example:
-- If you sell digital products, selecting the "Digital" category ensures they bypass the delivery address step at checkout.
-- If you offer large or heavy items, creating a "Freight" category helps separate those shipping methods from standard products.
+- Assigning a “Digital” category to non-physical products ensures they skip the shipping step during checkout.
+- Creating a “Heavy” category for large or heavy items allows you to limit specific shipping methods to those products.
### Tax Category
-![](/images/user/settings/shipping/10.10.1.7Shipping-TaxCategory.png)
+![Set a shipping method tax category in Spree](/docs/images/user/settings/shipping/7-tax-category.png)
+
+Use this setting to assign a Tax Category to the shipping method. This determines how taxes are applied to shipping charges at checkout.
-Here you can select the tax category that should apply to the shipping method.
+Different types of products may be subject to different tax rules, and assigning a tax category here ensures that shipping is taxed appropriately based on the contents of the order.
-Tax categories can impact shipping methods by determining the applicable tax rates based on the type of product being shipped. 
+For example:
+
+- In some regions, digital goods may be exempt from shipping tax, while physical goods are not.
+- Shipping charges related to tax-exempt products might also need to be excluded from tax calculations entirely.
-Certain tax rules may apply differently to specific product categories, affecting the final shipping cost and compliance with regional tax regulations.
+Assigning the correct tax category helps you stay compliant with local tax regulations and ensures customers are charged accurately.
### Calculator
-![](/images/user/settings/shipping/10.10.1.8Shipping-Calculator.png)
+![Choosing a shipping calculator in Spree](/docs/images/user/settings/shipping/8-shipping-calculator.png)
-The calculator section is where you can define the rules for calculating the cost of the shipping method. The calculator types are are follows:
+This section determines how the shipping cost will be calculated for this method. Spree offers several calculator types to support different pricing strategies:
-- Flat Percent
-- Flat Rate
-- Flexible Rate per package item
-- Flat Rate per package item
-- Price Sack
-- Digital Delivery
+- **Flat Percent** - charges a percentage of the order total as the shipping cost.
+- **Flat Rate** - charges a fixed shipping amount, regardless of order size or value.
+- **Flexible Rate per package item** - charges a base rate plus an additional amount for each item in the package (ideal for variable-size orders).
+- **Flat Rate per package item** - Applies the same fixed fee to every item in the shipment.
+- **Price Sack** - offers tiered pricing based on the total order value (e.g., $5 for orders under $50, free over $100).
+- **Digital Delivery** - used for digital products that don’t require physical shipping (typically results in no shipping cost).
+
+Each calculator type may reveal different fields depending on its configuration. Choose the one that best aligns with your fulfillment strategy.
For a more detailed guide on shipping calculators, please refer to another support article.
### Estimated Transit Business Days
-![](/images/user/settings/shipping/10.10.1.9Shipping-EstimatedTransit.png)
+![Set shipping method estimated transits days in Spree](/docs/images/user/settings/shipping/9-estimated-delivery.png)
-Here you can set an estimated delivery time that the customer will be able to see on both PDPs and checkout. 
+This optional setting allows you to display an estimated delivery time for the shipping method, visible on both the product detail page (PDP) and during checkout.
-While it’s not necessary to add this, estimated delivery times can improve conversions by setting clear expectations, giving customers confidence in when they will receive their order. 
+While not required, showing delivery estimates can help build trust, reduce cart abandonment, and improve conversions by setting clear expectations about when customers will receive their orders.
### Click Create
-Once you’ve configured all of the above settings, all you need to do is click the ‘Create’ button at the bottom of the page to save your new shipping method. It will become immediately available to customers provided the order details match the method’s conditions.
-
-Congratulations, you’ve just created your first shipping method\!
+Once you’ve configured all of the above settings, simply click **Create** at the bottom of the page to save your new shipping method. It will become immediately available to customers provided the order details match the method’s configuration.
-![](/images/user/settings/shipping/10.10.1.10Shipping-MethodCreated.png)
\ No newline at end of file
+Congratulations, you’ve just created your first shipping method!