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 or PDDP
• Customers must pay the customs & duties when placing their order
• Optional – visitors can choose to prepay customs & duties using a checkbox at checkout
• Display only – the customs & duties amount is shown for information only
• Customers cannot prepay but must acknowledge responsibility for paying themselves

Use this setting to select how customs & duties should be handled for visitors with orders that do 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.

• Neither DDP or PDDP should be used - visitors will not be able to prepay customs & duties at checkout
• DDP should be used - visitors' orders will be treated in the same way as delivery rates that are enabled for DDP
• PDDP should be used - visitors' orders will be treated in the same way as delivery rates that are enabled for PDDP

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), Postal Delivered Duty Paid (PDDP) or Neither. This controls whether customs & duties can be prepaid by the visitor as part of the order total and how the customs & duties are calculated.

• If a delivery rate is marked as Delivery rate supports DDP, visitors can prepay customs & duties depending on your app settings - customs & duties are calculated using a third party duty engine
• To calculate the customs & duties the duty engine uses the product's price, HS code and country of origin
• If a delivery rate is marked as Delivery rate supports PDDP, visitors can prepay customs & duties depending on your app settings
• To calculate the customs & duties ShopWired uses the product's price, country of origin and tariff for that country of origin
• If a delivery rate is marked as No duty prepayment, the customs & duties amount is still displayed at checkout, but visitors cannot select to prepay and must acknowledge responsibility instead
• Customs & duties are calculated using the DDP scheme
• 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 or PDDP

When creating or editing a delivery rate, select the Landed shipping costs tab and select a value for the Duty prepayment method setting if the delivery rate allows customers to prepay landed shipping costs.

When importing delivery rates through the delivery rate import system, in the Duty Prepayment Method column enter either DDP, PDDP or No.

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. Both items of data are required irrespective of the customs & duties calculation method.

• 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 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 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 by 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 either by the duty engine or ShopWired's tariff table, 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 support shows either None, PDDP or DDP depending on whether the selected delivery rate was marked as supporting DDP, PDDP or No prepayment
• 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/PDDP shows either DDP, PDDP or No, depending on whether the customer prepaid the duties and the delivery rate was configured for DDP or PDDP
• 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 customs & duties calculated (before uplifts)
• upliftAmount returns the total uplift applied
• totalAmount returns the final amount shown to the customer

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 of customs & duties calculated before any uplifts are applied
• order.customs_and_duties.uplift_amount returns the total uplift value (percentage + fixed) applied to the calculated amount
• order.customs_and_duties.total_amount 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.

Each ShopWired order invoice PDF theme is unique to the account that it is installed in. When the Landed cost calculator app is installed, your order invoice PDF theme will not automatically display customs & duties.

You can follow the instructions about HTML customisations to invoice PDF themes to adjust your invoice PDF theme to display the amount of customs & duties for an order or contact theme support for assistance.

If you are using the Formal theme and want to add the total amount of customs & duties, including any uplift, as a single line item you can add the code shown below above the grand total (around line 350).

If you are using the Standard theme and want to add the total amount of customs & duties, including any uplift, as a single line item you can add the code shown below above the grand total (around line 350).

If you are using the Basic theme and want to add the total amount of customs & duties, including any uplift, as a single line item you can add the code shown below above the grand total (around line 180).

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

No monthly fee or per-order fee will ever be charged for PDDP calculations.

ShopWired uses the tariff schedule below for calculating the tariff applied to a product, depending on its selected country of origin, when the visitor's selected delivery rate is configured for PDDP.

When using PDDP, some products are automatically exempt from customs & duties. These exemptions are based on the product’s HS code. If a product is exempt, it will not be included in the duty calculation, even if it has a valid country of origin.

The following HS codes are always excluded from PDDP calculations:

• Any HS code starting with:
• 9701 – Paintings, drawings and pastels
• 9702 – Original engravings, prints and lithographs
• 9703 – Original sculptures and statuary
• 9704 – Postage or revenue stamps, stamp-impressed paper, first-day covers, etc.
• 9705 – Collections and collectors’ pieces of zoological, botanical, mineralogical, historical, archaeological, palaeontological, ethnographic or numismatic interest
• 9706 – Antiques more than 100 years old
• 4901 – Printed books, brochures, leaflets
• 4902 – Newspapers, journals and periodicals
• 4903 – Children’s picture books and colouring books
• 4904 – Music, printed or in manuscript form
• 4905 – Maps and hydrographic or similar charts
• Specific HS codes that are also exempt:
• 4911.10.00 – Trade advertising material, commercial catalogues and the like
• 4911.91.10 – Pictures, designs and photographs

The above items are recognised as cultural works, antiques, or printed material, and under U.S. customs rules they do not attract import duties. To ensure accuracy, ShopWired automatically excludes them from PDDP duty calculations.

• Any HS code starting with:
• 7206 – Iron and non-alloy steel in ingots or other primary forms
• 7207 – Semi-finished products of iron or non-alloy steel
• 7208 – Flat-rolled products of iron or non-alloy steel, ≥600mm wide, hot-rolled
• 7209 – Flat-rolled products of iron or non-alloy steel, ≥600mm wide, cold-rolled
• 7210 – Flat-rolled products of iron or non-alloy steel, ≥600mm wide, clad/plated/coated
• 7211 – Flat-rolled products of iron or non-alloy steel, <600mm wide
• 7212 – Flat-rolled products of iron or non-alloy steel, <600mm wide, clad/plated/coated
• 7213 – Bars and rods, hot-rolled, in irregularly wound coils
• 7214 – Bars and rods, of iron or non-alloy steel, not in coils
• 7215 – Other bars and rods of iron or non-alloy steel
• 7216 – Angles, shapes and sections of iron or non-alloy steel
• 7217 – Wire of iron or non-alloy steel
• 7218 – Stainless steel in ingots or other primary forms
• 7219 – Flat-rolled products of stainless steel, ≥600mm wide
• 7220 – Flat-rolled products of stainless steel, <600mm wide
• 7221 – Bars and rods, of stainless steel, hot-rolled, in irregularly wound coils
• 7222 – Other bars and rods of stainless steel; angles, shapes, sections
• 7223 – Wire of stainless steel
• 7224 – Alloy steel in ingots or other primary forms
• 7225 – Flat-rolled products of alloy steel, ≥600mm wide
• 7226 – Flat-rolled products of alloy steel, <600mm wide
• 7227 – Bars and rods, of alloy steel, hot-rolled, in irregularly wound coils
• 7228 – Other bars and rods of alloy steel; hollow drill bars; angles, shapes, sections
• 7229 – Wire of alloy steel
• 7301 – Sheet piling, welded angles, shapes and sections of iron or steel
• 7302 – Railway or tramway track construction material of iron or steel
• 7304 – Tubes, pipes and hollow profiles, seamless, of iron or steel
• 7305 – Other tubes and pipes (e.g. welded), >406.4mm external diameter
• 7306 – Other tubes, pipes and hollow profiles of iron or steel
• 7315 – Chain and parts thereof, of iron or steel
• 7316 – Anchors, rivets, bolts, nuts, screws, washers, etc., of iron or steel
• 7317 – Nails, tacks, staples, corrugated nails, etc., of iron or steel

All HS codes listed above beginning with 72, 73, 7315, 7316 or 7317 fall within the scope of U.S. Section 232 steel measures. Under normal U.S. customs law these products attract additional tariffs (50% for most countries of origin, 25% for UK until 9 July 2025, plus possible Section 301 duties for Chinese origin). However, when imported via postal carriers under the IEEPA reciprocal tariff system, Section 232 products are specifically excluded from the duty tables. As a result, Royal Mail and other postal operators treat these items as duty-free under PDDP, apart from their handling charge. For accuracy, ShopWired’s PDDP calculations automatically exclude these HS codes, even though they are not truly duty-free if shipped under a courier/DDP method.

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