Shopify extensibility

Shopify Plus Advanced Settings

Enhanced customization options available exclusively for Shopify Plus merchants.

BETA PHASE

After completing the basic setup, Shopify Plus merchants can enable advanced features through Shopify's Extensibility API. These features provide enhanced control over the checkout experience, including detailed duty and tax breakdowns, automatic discount recalculation, and expanded customization options.

For general setup and display settings, see our standard Shopify settings guide.

Checkout display settings 

Two additional options are available to Shopify Plus merchants in the Checkout display settings section.

Use enhanced duty and tax breakdown

Display a more detailed and customizable breakdown of duties, taxes, and fees in the checkout with enhanced line item control and regional customization.

Use discounted amounts in rate requests

When enabled, discounts applied to the cart will be factored into the calculation of duties, taxes, and fees. This ensures that customers see accurate landed costs even when promotional codes are applied.

App block required

Both Shopify Plus features require the Shopify app block to be installed in your checkout to integrate with Shopify's checkout interface and detect cart changes like discount codes and display enhanced breakdowns.


Enhanced breakdown customization 

When Use enhanced duty and tax breakdown is selected, additional customization options become available.

Regions

Enhanced breakdowns can be configured per region using the same region system described in the general settings guide. This allows you to customize breakdown displays differently for specific countries or groups of countries.

Checkout preview with enhanced breakdown

The Preview section shows how the enhanced breakdown will appear to customers at checkout. This includes a Pricing Summary section with:

  • Shipping costs and estimated delivery time (e.g., "Estimated arrival time 2–5 days")
  • Individual tax amounts
  • Duties and fee amounts
  • Explanatory messaging about the total landed cost

The preview updates in real-time as you adjust settings.

Breakdown heading

Customize the title that appears above the detailed breakdown (default: "Pricing summary").

Breakdown line items

Configure line items shown in the breakdown. Options include:

  • Line description: Custom label (e.g., "Shipping", "Taxes", "Duties and fees")
  • Value(s): Select which amounts to display (e.g., "Shipping", "Taxes", "Duties, Fees")
  • Hide line when value is zero: Hide lines with zero amounts for cleaner display
  • Show shipping time: Show estimated delivery time with shipping lines

Default line items include:

  • Shipping line with delivery time estimates
  • Tax line with calculated tax amounts
  • Duties and fees line with combined amounts

You can add additional custom breakdown items using Add line.

Breakdown explanation

Add explanatory text (default: hidden) at the bottom of your shipping method and pricing summary breakdown to help customers understand the total landed cost. For example: "This is a total landed cost, direct to your door with no extra costs from your local customs."

Custom messages

Insert additional custom messages within the breakdown display to provide context, reassurance, or important shipping information:

  • Display above breakdown: Shows before the pricing details
  • Display below breakdown: Shows after the pricing details

Use + Add custom message to create multiple entries.

Examples uses:

  • Return policies: "Free returns on international orders over $100"
  • Processing times: "Orders ship within 1-2 business days"

Discount support 

When Use discounted amounts in rate requests is enabled, UPS Global Checkout will automatically:

  • Recalculate shipping rates using the discounted order value
  • Adjust duties and taxes accordingly
  • Update the landed cost total in real-time
  • Display the accurate final cost including all discounts

Setting up Shopify Plus features 

Step 1: Enable features in the app

  1. Go to the UPS Global Checkout app in your Shopify admin
  2. In the Checkout display settings section (visible only for Shopify Plus stores), check:
    • Use enhanced duty and tax breakdown (recommended)
    • Use discounted amounts in rate requests (recommended)
  3. Configure the detailed options that appear for enhanced breakdown and preview how it will look at checkout in the Preview section
  4. Click Save changes

By default, these display settings will apply globally to all countries. You can customize these settings for specific countries by clicking Create Custom Region in the top right corner.

Step 2: Add the app block to your checkout

  1. In Shopify admin, go to Settings → Checkout → Customize
  2. At the bottom, click Add App Block
  3. Select UPS Global Checkout Plus Features
  4. Expand the block and check both options
  5. Click Save

Without this app block:

  • Discount codes will not trigger recalculation
  • Enhanced breakdowns will not display at checkout

Support 

For Shopify Plus–specific features or advanced customization support, email globalcheckoutsupport@ups.com.

When contacting support, include:

  • Your UPS shipper number
  • Shopify Plus store details
  • Which extensibility features you are using
  • Configuration questions or error details

Was this page helpful?