Knowledge Base


  • Video block
  • Video Tutorials

  • Watch our easy-to-follow video tutorials for quick tips on designing and managing your store.
  • View Video Tutorials

Configuration: Shipping Methods - UPS

System > Configuration > Sales > Shipping Methods - UPS


The UPS section lets you enable and configure the UPS shipping method.

For step-by-step instructions, see Shipping Carriers: Setting Up UPS.

Field Descriptions

Options Scope Description
Enabled Website Enables/disables the UPS shipping method.
UPS Type Website Specifies the method that Magento Go uses to connect to the UPS shipping system. The available options are:
  • United Parcel Service - Your store sends key-value pairs to UPS as a request. If this option is selected, the URL to connect to UPS must be specified in the Gateway URL field.
  • United Parcel Service XML - Your store sends an XML file with data to UPS as a request.
Password Website UPS shipper account password.
Access License Number Website UPS shipper account access license number
UserID Website UPS shipper account user ID
Mode Website Sets the mode of transmission for data sent to the UPS system.
  • Live - Data is insecurely sent to UPS.
  • Development - Data is securely sent to UPS.
Gateway XML URL Website The URL to connect to when transmitting an XML data file.
Origin of the Shipment Website The country or region where the product shipment is originating from. Used to accurately calculate shipping rate.
Enable Negotiated Rates Website Set this option to Yes if you have signed special rates with UPS.
Shipper Number Website If you have set Enable Negotiated Rates to “Yes,” this field indicates your shipper number and is used by the UPS system to reference your negotiated rates.
Gateway URL Website The URL used to connect to the UPS system and retrieve shipping rates dynamically.

Note: This URL is used when UPS Type “United Parcel Service” is selected. For the “United Parcel Service XML” type, the Gateway XML URL will be used.

Title Store View The title of this shipping option as it appears in the shopping cart checkout.
Container Website

Sets the container type used to package order shipments.

Options include:
  • Customer Packaging
  • UPS Letter Envelope
  • UPS Tube
  • UPS Express Box
  • UPS Worldwide 25 kilo
  • UPS Worldwide 10 kilo
Destination Type Website Sets the default shipment destination type to one of the following:
  • Residential
  • Business
  • Define Automatically - UPS determines the destination type as either residential or commercial, and uses the appropriate rate from the merchant’s UPS account during checkout.
Weight Unit Website Sets the default unit of measurement for product weight in your store
Pickup Method Website

Sets the UPS pickup method.

Options include:
  • Regular Daily Pickup
  • On Call Air
  • One Time Pickup
  • Letter Center
  • Customer Counter
Maximum Package Weight Website

Sets the maximum weight that a package can be as specified by UPS.

If the products ordered exceeds the maximum package weight, this shipping option will not be available.

According to, packages cannot exceed 150lbs (70kg).

Minimum Package Weight Website

Sets the minimum weight that a package can be as specified by UPS.

If the products ordered weigh less than the minimum package weight, this shipping option will not be available.

Calculate Handling Fee Website

Sets the handling fee calculation method for table rate shipping.

  • Fixed - Handling fee is a fixed rate.
  • Percent - Handling fee is applied as a percentage of the order amount.
Handling Applied Website Specifies whether handling fee is applied to each order or to each package within an order.
Handling Fee Website

Sets the handling that is included with the shipping rate price. Handling fee can be set as a fixed amount or a percentage.

Note: If typing a percentage amount, use the decimal format 0.25 for 25%.

Allowed Methods Website Specifies the allowed methods of UPS shipping that will be offered to customers. Shipping rates will be calculated based on the selected shipping method.
Free Method Website Sets the free shipping method through UPS, or can be disabled by selecting None.

Note: This shipping method is similar to the regular Free Shipping method, however it will be listed within the UPS shipping options and is identified as UPS shipping.

Free Shipping with Minimum Order Amount Website Enables or disables conditional free shipping that depends on meeting a minimum order amount.
Minimum Order Amount for Free Shipping Website Sets the minimum total order amount that must be met to qualify an order for free shipping.
Displayed Error Message Store View The error message that is displayed when this shipping method is unavailable for any reason.
Ship to Applicable Countries Website

Specifies which country customers are allowed to use this shipping method.

All Allowed Countries - All allowed countries are applicable to use the free shipping method. The Allowed Countries are specified in the General configuration page.

Specific Countries - Limits this shipping option to the countries specified in the Ship to Specific Countries list.

Ship to Specific Countries Website Specifies the countries that are applicable to use the UPS shipping method. This selected countries list is used if Ship to Applicable Countries is set to “Specific Countries.”
Debug Website

Specifies if data transmissions between Magento Go and UPS will be logged in the system for debugging.

Unless there is an issue that needs to be tracked and logged, this should be set to No.

Show Method if Not Applicable Website

If set to “Yes,” the UPS shipping option appears in the shipping methods list, regardless of whether or not the order qualifies to use it.

If set to “No,” the UPS shipping option does not appear in the shipping methods list unless it is applicable to the order.

Sort Order Website

Sets the sort order value for this shipping method. This value, relative to other shipping methods, determines the displayed order of shipping options in checkout.

Shipping methods are displayed in ascending order based on sort order value.