---
title: Working with free shipping offers
related:
- https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-free-shipping-offers/example-redeeming-a-free-shipping-offer.md
- https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes.md
- https://docs.kentico.com/13/e-commerce-features/customizing-on-line-stores/configuring-discount-rules.md
- https://docs.kentico.com/13/e-commerce-features/customizing-on-line-stores/configuring-discount-rules/adding-a-discount-rule-with-a-custom-method.md
- https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes/example-applying-a-coupon-code-to-receive-free-shipping.md
---
> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).
You can use free shipping offers to provide free shipping to your selected [customers](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/customers.md).
For example, use this discount when you want to give free shipping:
- to customers who buy goods for more than a specific price, e.g., 100 USD;
- to customers who have their purchased products sent to somewhere where you want to increase sales, e.g., to Texas;
- because of the current season, e.g., Christmas.
You can configure free shipping offers in detail to apply only if specified rules (macro conditions) are fulfilled. These rules use properties of the shopping cart, and can include shopping cart content, billing/shipping address, [order](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders.md) currency, order amount, etc. You can also specify periods of validity for free shipping offers.
> **Info:** The system binds free shipping offers to specific sites.
>
> If you run [multiple sites](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/choosing-site-or-global-e-commerce-configuration.md) and want to use free shipping offers, you thus need to define dedicated free shipping offers for each site.
## Adding and editing free shipping offers
You can add or edit free shipping offers in the **Free shipping offers** application.
- [Free shipping offers limited by periods of validity](#free-shipping-offers-limited-by-periods-of-validity)
- [Free shipping offers targeted at selected customers](#free-shipping-offers-targeted-at-selected-customers)
- [Free shipping offers limited by conditions](#free-shipping-offers-limited-by-conditions)
> **Info:** You can combine the free shipping offer limitations.
>
> For example, you can provide free shipping to all your registered US customers who placed their orders throughout January.
### Free shipping offers limited by periods of validity
To add or to edit free shipping offers limited by periods of validity:
1. To add a new offer, click**New Free shipping offer**. To edit an existing offer, click **Edit** () at the desired offer.
2. Type a **Name** for the discount.
3. Enter the free shipping offer properties in the **Duration** category.
- **Valid from** – specifies the start of the period of validity.
- **Valid to** – specifies the end of the period of validity.
> **Info:** Leave both fields empty for permanent validity.
4. Click **Save**.
The system saves the free shipping offer. The system now provides free shipping only during the offer's period of validity (if the offer is running).
### Free shipping offers targeted at selected customers
To add or to edit free shipping offers targeted at selected customers:
1. To add a new offer, click**New Free shipping offer**. To edit an existing offer, click **Edit** () at the desired offer.
2. Type a **Name** for the discount.
3. Change the value of the **Available for** property in the **Target customers** category
- **All visitors** – all customers are eligible for the discount; the default option.
- **Registered users** – only registered customers are eligible for the discount.
- **Registered users in selected roles** – only registered customers in selected [roles](https://docs.kentico.com/13/managing-users/role-management.md) are eligible for the discount.
4. Click **Save**.
The system saves the free shipping offer and returns you to the list of all free shipping offers. The system provides free shipping only to the selected customers.
> **Info:** If you need to add free shipping offers targeted at custom groups of customers, for example, on selected users, contact groups, etc., please refer to [Configuring discount rules](https://docs.kentico.com/13/e-commerce-features/customizing-on-line-stores/configuring-discount-rules.md).
### Free shipping offers limited by conditions
To add or to edit basic free shipping offers limited by conditions:
1. To add a new offer, click**New Free shipping offer**. To edit an existing offer, click **Edit** () at the desired offer.
2. Type a **Name** for the discount.
3. Specify **Minimum order amount** in your on-line store [main currency](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).
4. Click **Edit** to set the discount rules and their parameters
1. In **Edit macro condition** dialog that opens, select the required rule in the right part of the dialog.
2. Use drag & drop, or double-click, or click **Add rule** () button to add the rule.
3. Click the underlined parts of the rule in the left part of the dialog to open the **Set parameter value** dialog.
4. Select the desired parameter.
5. Click **OK**.
6. (Optional) Repeat editing to set all discount rules and all their parameters you want.
7. Click **Save & Close**.
5. Click **Save**.
The system saves the free shipping offer. The system now applies the offer only if the specified conditions are fulfilled (if the offer is running).
> **Info:** **Effects of discount modification on already existing orders**
>
> If you edit or delete a discount, existing orders do not change and remain with the original discount. To update existing orders according to the new rules, you need to edit the orders manually.
## Displaying the remaining amount to receive free shipping on pages
To display the amount that remains for customers to receive free shipping for their orders (if eligible) on your website, you need to use the Xperience API.
Calculate the remaining amount by calling the **CalculateRemainingAmountForFreeShipping()** method of the current **shopping cart** object. You can then display the value anywhere in your MVC site's views. See [Integrating the shopping cart](https://docs.kentico.com/13/e-commerce-features/developing-on-line-stores/implementing-a-checkout-process/integrating-the-shopping-cart.md) for an example.
## Displaying the shipping costs in invoices
To display the total shipping costs in [invoices](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-invoices.md):
1. Open the **Store configuration** application.
2. Switch to the **Invoice** tab.
3. Add the following macro code into your invoice template:
```xml
{% TotalShipping.Format(Currency.CurrencyFormatString) %}
```
4. Click **Save**.
If you now review an existing order on the **Invoice** tab in the **Orders** application, you can see that the invoice includes information about the shipping costs. The value is _0_ if no shipping is charged for the selected shipping option, or if free shipping is provided to the customer.
## Reference
| General | |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | The name of the free shipping offer used throughout the administration interface, e.g., in free shipping offer lists. |
| Code name | The unique identifier of the free shipping offer (for example used by developers in code).
Unless there is a reason to set a particular value, you can leave the default _(automatic)_ option, and the system generates an appropriate code name automatically. |
| Description | To make the free shipping offer easier to use and maintain, you can add an explanation about the scenarios for which the offer is intended, etc. The description doesn't have any functionality, it's just for better orientation.
You can add an explanation about the scenarios for which the free shipping offer is intended. The description does not affect the offer's functionality, apart from providing information to store managers working in the _Free shipping offers_ application. |
| Enabled | Indicates whether the offer is available for use by customers. While calculating the shipping costs of orders, the system skips disabled free shipping offers. |
| Free shipping conditions | |
| Minimum order amount | Specifies the minimum price total that orders must have for the free shipping offer to be applicable. The price is evaluated **after** calculating all other types of [discounts](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts.md), but **before** adding [taxes](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md) to the order total.
Set the value in the site's [main currency](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).
If you leave an empty value, all orders are eligible unless limited by the **Further conditions** field. |
| Further conditions | Adds further conditions that must be fulfilled to apply the free shipping offer.
Click **Edit** to open the **Edit macro condition** dialog, which allows you to add rules through a graphical interface.
To add rules to the condition, double-click rules on the right or click **Add rule** ().
To remove a rule from the condition, select it and click **Delete** (). Click **Clear all rules** () to remove all added rules.
Click on underlined words in the rule text to configure various rule options.
**Example**
_Shipping option is Shipping_
_and_
_Shipping address state is Texas_
The condition ensures that the free shipping offer is only applied if the customer selects shipping as shipping option, and have their purchased products sent to Texas.
You can also edit macros on the **Code** tab in the **Edit macro condition** dialog. For details about available macro options and syntax, please refer to [Macro expressions](https://docs.kentico.com/13/macro-expressions.md). |
| Coupons | |
| Customer has to redeem a coupon to get Free shipping | If selected, only customers who enter a valid coupon code are able to apply the discount.
You can set coupon codes on the **Coupons** tab in the left menu. After enabling the field and saving the discount, you will be redirected there automatically.
To learn more, see: [Working with coupon codes](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/discounts/working-with-coupon-codes.md) |
| Duration | |
| Valid from | Specifies the time and date from which the offer can be applied. If you leave the value empty, the offer can be applied at any time before the **Valid to** date. |
| Valid to | Specifies the time and date until which the offer can be applied. If you leave the value empty, the offer is valid permanently (starting from the **Valid from** date). |
| Target customers | |
| Available for | Determines which types of users are able to use the offer:
**All visitors** – all customers are eligible for the offer.
**Registered users** – only registered customers are eligible for the offer.
**Registered users in selected roles** – only registered customers in selected [roles](https://docs.kentico.com/13/managing-users/role-management.md) are eligible for the offer. To add roles:
Click **Select** to open the **Select roles** dialog.
Select the required roles.
Click **Select**.**Tip:** You can add registered customers to roles in the **Customers** application while editing a selected customer on the **Roles** tab. |