Landed cost calculator

WARNING: Your account must be configured to use the shipping on checkout configuration to use the landed cost calculator app.

The Landed cost calculator app allows you to calculate and, where required, collect customs & duties on orders delivered to the United States, Puerto Rico, and U.S. Virgin Islands. The duties are calculated using a third-party duty engine and can either be included in the order total, offered as an option for customers to prepay, or displayed for acknowledgement only.

To install the app:

1. Navigate to Apps
2. Locate the Landed cost calculator app
3. Select install this app

---

About customs & duties

When goods are imported into the United States from overseas, they may be subject to a range of charges collected by U.S. Customs and Border Protection. These charges can include:

• Customs duties (based on the product’s classification and origin)
• Merchandise processing fees, harbour maintenance fees (for sea freight)
• Tariffs (broad trade measures that may apply on top of normal duties)
• And in some cases, other import-related taxes

The Landed Cost Calculator app uses third-party services to estimate these costs and, depending on your settings, can either add them to the order total or display them at checkout for the customer to acknowledge.

Customs & duties only apply to imports into the United States, Puerto Rico, and U.S. Virgin Islands. They do not apply to other U.S. territories such as Guam, American Samoa, or the Northern Mariana Islands. Orders shipped to these locations will not be subject to calculation by the landed cost calculator.

---

App settings

To manage the app's settings, navigate to Checkout > Landed cost calculator.

Landed cost calculator enabled

Use the toggle to turn the Landed cost calculator app on or off. When this setting is deselected, no customs & duties are calculated or displayed at checkout and no charges are applied to orders.

Collection requirement

Control how customers interact with customs & duties:

• Mandatory – the calculated amount is always included in the order total when the delivery rate supports DDP
  • Customers must pay the customs & duties when placing their order
• Optional – customers can choose to prepay customs & duties using a checkbox at checkout
• Display only – the custom & duties amount is shown for information only
  • Customers cannot prepay but must acknowledge responsibility for paying themselves

Other delivery charges

Enable this setting if you want customs & duties to available to be paid by customers where their order does not contain a standard delivery rate (i.e. the order only contains products which have specific delivery pricing or wholesale delivery is applied to their order.

Uplifts

Uplifts allow you to adjust the calculated customs & duties by adding extra amounts on top of the base figure returned by the duty calculation. They are useful if you want to recover additional costs associated with managing imports or if you need to build in an overhead margin.

• Uplifts are added after the base customs & duties amount is calculated
• Customers see the uplift included within the total Customs & duties line at checkout
• In ShopWired’s integrations with apps such as accounting or shipping platforms, uplifts are returned separately so that only the base customs & duties are sent as part of the duty calculation

Percentage uplift

Use this setting to increase the calculated customs & duties by a percentage value (0–100, up to two decimal places). For example, if the duty engine calculates £20 and you set a 5% uplift, the final amount shown to the customer will be £21.

Fixed uplift

Use this setting to add a fixed currency amount to the calculated customs & duties (e.g. £1.50). Like the percentage uplift, this amount is shown to customers as part of the Customs & duties line but is stored separately from the base calculation in exports and integrations.

---

Delivery rate settings

When using the Landed cost calculator, you can choose whether a delivery rate supports Delivered Duty Paid (DDP). This controls whether customs & duties can be prepaid by the visitor as part of the order total.

• If a delivery rate is marked as supporting DDP, customers can prepay customs & duties depending on your app settings
• If a delivery rate is not marked as supporting DDP, the customs & duties amount is still displayed at checkout, but visitors cannot select to prepay and must acknowledge responsibility instead
  • If you have configured the Collection requirement for customs & duties to be mandatory then visitors will still be unable to prepay customs & duties if their selected delivery rate is not marked as supporting DDP

Creating / editing delivery rates

When creating or editing a delivery rate, select the Landed shipping costs tab and select the This delivery rate supports DDP setting if the delivery rate allows customers to prepay landed shipping costs.

Delivery rate import system

When importing delivery rates through the delivery rate import system, enter Yes in the DDP Support column to mark a delivery rate as supporting prepayment of landed shipping costs.

---

Product settings

For the Landed cost calculator to be able to calculate the customs & duties, every product in the visitor's basket must have both an HS code and a Country of origin.

• The HS code (Harmonised System code) identifies the type of goods being shipped and determines the applicable duty rate
• The Country of origin specifies where the product was manufactured or produced, which is also used to determine duty rates

If either value is missing for a product, customs & duties cannot be calculated for the order.

Creating / editing products

When creating or editing a product, navigate to the Additional information section and in the Product identifiers tab enter the HS code and select the Country of origin from the dropdown list.

Product import system

When using the product import system, use the columns HS Tariff Code and Country Of Origin.

The country of origin must be entered as the full country name (for example, United Kingdom) using the same format available in the dropdown list on the product page.

---

Product extras

Product extras are treated as separate line items when calculating customs & duties, provided they are linked to a product that has its own SKU code. For customs & duties to be calculated on a product with extras, both the parent product and all linked extras must have an HS code and a Country of origin.

• If all linked extras and the parent product include valid HS codes and countries of origin, each extra is sent as a separate line item to the duty engine at its configured price
  • The parent product’s value is reduced accordingly so that the combined values always match the basket line total
• If any linked extra or the parent product is missing an HS code or a Country of origin, the entire line (the parent product and its extras) is excluded from duty calculations

WARNING: If either the parent product or any linked extra is missing an HS code or a Country of origin, customs & duties will not be calculated for the order.

---

Product bundles

Product bundles are treated as a collection of their constituent products when calculating customs & duties. For duties to be calculated correctly, each constituent product in the bundle must have an HS code, a Country of origin, and a value entered for the Percentage price contribution setting.

How percentage price contribution works

The Percentage price contribution setting determines how the bundle price is divided across its constituent products. Each percentage allocates part of the bundle’s total price to a specific product, which is then used to calculate its customs & duties value.

For example, if a bundle costs £2,000 and contains:

• Product A, quantity 3, with a 30% price contribution
• Product B, quantity 1, with a 70% price contribution

The calculation is:

• Product A contributes £600 (30% of £2,000), which divided by 3 units equals £200 per unit
• Product B contributes £1,400 (70% of £2,000), which equals £1,400 per unit

These apportioned unit prices are the values sent to the duty engine for customs & duties calculations.

Percentage price contribution

The Percentage price contribution determines how much of the bundle’s price is attributed to each constituent product. This allows the Landed cost calculator to work out an accurate unit price for each item in the bundle.

• If the percentages across all constituent products add up to 100, each product is sent as a separate line item to the duty engine with the correct apportioned value
• If the percentages do not add up to 100, the entire bundle is excluded from duty calculations

WARNING: If any constituent product is missing an HS code, a Country of origin, or a percentage price contribution, customs & duties will not be calculated for the order.

Creating / editing product bundles

When creating or editing a product bundle:

• Enter the HS code and select the Country of origin for each constituent of the bundle
• Specify the Percentage price contribution for each constituent product on the product bundle
  • The percentages across all constituents must total 100

Importing product bundles

When using the product import system:

• Specify the Percentage price contribution for each constituent product by adding it after the SKU and quantity in the Bundle Products column
  • Separate with a pipe (|)
• For example, SKU124 x 3 | 6 means SKU SKU124 has a quantity of 6 in the bundle and contributes 60% of the bundle price

Item ID	Bundle	Bundle Products	Bundle Title	Bundle Image
123456	Yes	SKU123 x 1 | 40 , SKU124 x 3 | 60

---

Checkout customisation settings

In the checkout customisation settings, the Landed cost calculator section allows you to customise the text displayed to visitors when customs & duties apply. These settings determine the information shown. In some cases, the text is accompanied with a checkbox is displayed that the visitor must select before they can continue with checkout.

Customs & duties section at checkout[700]

Text shown when duties/taxes are always included in the order total

The text in this setting is used when customs & duties are mandatory and included in the order total. This text is displayed without a checkbox.

The default text is:

Import duties and customs fees are included in your order total. You will not be charged any additional amounts on delivery.

Text shown when the visitor can choose whether to prepay duties/taxes

The text in this setting is used when customs & duties are optional and visitors can decide whether to prepay. This text is displayed alongside a checkbox that visitors can choose to select to prepay duties.

The default text is:

Select to prepay import duties and customs fees now to avoid additional charges on delivery.

Text shown when duties/taxes are not collected

The text in this setting is used when customs & duties are displayed for acknowledgement only and cannot be prepaid. This text is displayed with a mandatory acknowledgement checkbox.

The default text is:

Import duties and customs fees are not included in your order total. I acknowledge responsibility for paying these charges directly to the courier before my order is delivered.

Text shown when duties/taxes cannot be calculated

The text in this setting is used when customs & duties cannot be calculated (for example, missing HS codes and countries of origin, or issues with the duty engine). This text is displayed with a mandatory acknowledgement checkbox.

The default text is:

Import duties and customs fees are not included in your order total and we are currently unable to calculate them. I acknowledge responsibility for paying these charges directly to the courier before my order is delivered.

---

Checkout behaviour

When the Landed cost calculator app is enabled, a Customs & duties section appears during checkout if the visitor’s delivery address is in the United States, Puerto Rico, or U.S. Virgin Islands. The text displayed, whether a checkbox is required, and whether the amount is included in the order total depend on your configuration and the delivery rate selected by the visitor.

In all cases where a checkbox is shown, it must be selected by the visitor before they can continue with checkout.

Display in the order summary

• When duties are prepaid (mandatory or optional with the checkbox ticked), the Customs & duties line appears in the order summary above the grand total and is included in the total amount charged.
• When duties are not prepaid (optional not ticked, or display only), the Customs & duties line appears beneath the grand total and is not included in the total amount charged.

Scenarios

App enabled	Delivery rate supports DDP	Collection requirement	Message shown	Duties added to grand total	Checkbox required
Yes	Yes	Mandatory	Text shown when duties/taxes are always included in the order total	Yes	No
Yes	Yes	Optional	Text shown when the visitor can choose whether to prepay duties/taxes	Yes, if checkbox ticked	Yes
Yes	Yes	Display only	Text shown when duties/taxes are not collected	No	Yes
Yes	No	Mandatory	Text shown when duties/taxes are not collected	No	Yes
Yes	No	Optional	Text shown when duties/taxes are not collected	No	Yes
Yes	No	Display only	Text shown when duties/taxes are not collected	No	Yes
Yes	Any	Any (missing HS code or origin)	Text shown when duties/taxes cannot be calculated	No	Yes

HINT: If the app is disabled or the destination is outside the supported countries, the Customs & duties section will not appear at checkout.

---

Admin orders

When creating or editing an order manually in admin, customs & duties are handled in a similar way to checkout but with some differences in how they are applied.

• A calculate taxes option is available on the order creation page
  • Selecting this option will calculate the customs & duties for the order
• After calculation, the Customs & duties amount will be shown in the order summary
  • If the collection requirement is set to Mandatory, the amount is automatically included in the grand total
• If the collection requirement is set to Optional or Display only, a Duties option allows you to choose whether the duties should be prepaid (Pre-paid) or not (Not paid)
  • This option replaces the customer-facing checkbox shown during checkout

Once the order is created, customs & duties are recorded on the order in the same way as website orders and, where prepaid, are displayed in the order totals above the grand total.

---

Viewing orders

When an order includes customs & duties, a Customs & duties section is shown when viewing the order within your ShopWired account. This section provides a breakdown of how the amount was calculated and additional information that can help you understand or troubleshoot the result.

The following values can be shown:

• Calculated customs & duties shows the amount returned by the duty engine before any uplifts are applied
• Total uplift applied shows the combined total of percentage and fixed uplifts configured in your account
• Final customs & duties shows the total amount shown to the customer at checkout (calculated duties + uplifts)
• Added to grand total indicates whether the final customs & duties were included in the order’s grand total (applies when duties are prepaid or mandatory)
• Customer acknowledgement given shows whether the customer confirmed responsibility for duties by ticking a checkbox during checkout
• Customs & duties prepaid shows whether the customer prepaid the duties (Yes/No)
• Collection requirement shows which collection requirement applied at the time of checkout (Mandatory, Optional, or Display only)
• Acknowledgement required shows whether the customer was required to acknowledge responsibility for duties at checkout
• Delivery rate supports DDP shows whether the selected delivery rate was marked as supporting DDP
• Products valid confirms whether all products in the order had the required HS codes and countries of origin to allow duty calculation

In addition, the section includes view logs which open detailed records in a modal window:

• Checkout text shown to customer shows the exact wording that appeared at checkout, including any acknowledgement text or instructions
• API request log shows the information sent to the duty engine, including shipping details and product data used for the calculation
• API response log shows the calculation returned by the duty engine, including the duty amount, any additional charges, and calculation notes
• Product details log shows the product information that was processed for the calculation, including identifiers and line item values

These logs are provided to help you diagnose why a particular calculation was made, or why duties may not have been calculated.

---

Orders & exports

When an order is completed, customs & duties are stored with the order and displayed throughout your ShopWired account.

Order page

• On the order page in admin, the Customs & duties amount is shown above the grand total if the duties were prepaid or mandatory
• If the duties were not prepaid, the amount is shown in the Customs & duties section of the order instead, along with details of the calculation and acknowledgement status.

Orders CSV export & feeds

• The Orders CSV export and order feeds include additional columns when at least one order contains customs & duties:
  • Customs & Duties shows the calculated amount (including any uplift)
  • Customs & Duties Uplift shows the uplift value applied
  • DDP shows either Yes or No, depending on whether the customer prepaid the duties
  • SW LCC Fee shows the usage fee charged for the order by ShopWired

API & webhooks

• The order API and webhooks include a customsAndDuties object with three properties:
  • amount returns the amount returned by the duty engine (before uplifts)
  • upliftAmount returns the total uplift applied
  • totalAmount returns the final amount shown to the customer

Twig objects

For theme developers, the order.customs_and_duties Twig object can be used to output customs & duties amounts in theme templates. This object contains the following properties:

• order.customs_and_duties.amount returns the amount returned by the duty engine before any uplifts are applied
• order.customs_and_duties.upliftAmount returns the total uplift value (percentage + fixed) applied to the calculated amount
• order.customs_and_duties.totalAmount returns the final amount displayed to the customer at checkout (the sum of the base amount and the uplift)

These properties allow you to display the duties separately or as part of the order summary in customised theme designs.

---

Billing & fees

Throughout the month of September 2025 the Landed cost calculator app will be free of charge to install and use.

No monthly fee or per-order fee will be charged on any orders where customs & duties are calculated.

---

Limitations

The Landed cost calculator cannot always be used.

There are specific scenarios where customs & duties will not be calculated, and visitors will instead see the fallback acknowledgement text at checkout.

• All products in the basket must have both an HS code and a Country of origin
• If any product, product extra, or bundle constituent is missing these values, customs & duties cannot be calculated for the order
• If bundle products are used, the Percentage price contribution for each constituent must be set and must add up to 100; otherwise the bundle is invalid and duties cannot be calculated
• Digital products are excluded from duty calculations
• Gift vouchers are excluded from duty calculations
• If any invalid items are present in the basket, the calculator will not attempt to calculate duties for any part of the order

HINT: These restrictions are designed to prevent incomplete or inaccurate customs calculations.