Landed cost calculator

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

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.

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

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 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

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.

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.

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

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.

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.

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.

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.

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 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

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.

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.

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

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

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

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.

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.

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.

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.

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.

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.

• 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.

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.

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.

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

• 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.

• 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

• 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

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.

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.

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